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INSTRUCTIONS 



EDITORS COMMENT 



Most 'ii you will by now have* tfccovwd (he new price 
for CDU. We are very sorry (hat we have had to make this 
increase la the cost of your favourite C64 magazine. Like 
everyone else, we are constancy al the mercy of the 
general economic climate of the country. However, we 
do feel that even al the new price of £3.25, CDU still 

gives iiul.l.irnling v.illli- lor ni>'ie\ .ii'iil :\i v.il ■ 

to continue (o keep up the standards. 

I hope you like the new style disk sleeve and disk logo. 
Many of you have staled your preference lo having I he 
VOLUME and DISH number on Ihe disk, instead of on the 

This months issue is full of interesting features which I 
trust you will find will be of some benefit to you. One of 
Ihe programs on Ihe disk., namely "Turbo Loader" does not 
have any text associated with it. This is due to the fad 
that we received it too late for printing. However, the 
program is self explanatory so it should not present you 
with any problems. Please enjoy this issue. 



DISK INSTRUCTIONS 



Although we do everything possible to ensure that CDU 
is compatible with all C64 and CUB computers, one 
point we must make clear is this. The use of 'Fast 
Loaders', 'Cartridges' or alternative operating systems 
such as 'Dolphin DOS', may not guararilee that your disk 
will function properly. If you experience problems and 
you have one of the above, then we surest vou disable 
Ihem and use the computer under normal, standard 
conditions. Getting (he programs up and running should 
not present vou with any difiii ulties, simply put your disk 
in the drive and enter the command. 

LOAD"MENU",8,1 

Once the disk menu has loaded you will be able to start 
any of [he programs simply be selecting Ihe desired one 
imm Ihe lisl. II is possible ror some programs lo alter the 
computers memory so lhat you will not be able to LOAD 
programs from ihe menu correctly until you reset the 
machine. We therefore suggest that you turn your 
computer off and then on again, before loading ea< h 
program. 

HOW TO COPY CDU FILES 

You are welcome lo make as many of your own copies of 
CDU programs as you want, as long as you do not pass 



them on lo other people, or worse, sell them for profit. 
For people who want to rn.ike legiiimale ( opies, we have 
provided a very simple machine c ode file ropier. To use 
it, simply select the item FILE COPIER from the main 
menu. Instructions are presenled nn screen. 

DISK FAILURE 

If for any reason the disk with your copy of CDU will not 
work on your system then please carefully re-read the 
operating instructions in the magazine. If you still 
experience problems then: 



l If yi 'ii are a suhsi 
Seleil 5utsc liplio 
5, River Park Fsl.it 


he'd return " ' 


MM||H| 

■H 


Telephone; 0442 876661 


1. If you bough) ii ii 




CDU Replacements 

STANLEY PHECIStON DAIA SYSTEMS LTD 


Cavendish Qiunyd 
Sallow Road 
Weldon North Ind 


.1 

Strial Estate 




Telephone; 0S36 61787' 



Within eight weeks of publication date disks are replaced 



Alter right weeks a replacement disk can be supplied 
from STANLEY PRECISION DATA SYS11MS LTD for a 
service charge of £1.00. Return the faulty disk with a 
cheque or poslal order made oul to STANLEY PRECISION 
DATA SYSTEMS LTD and dearly state the issue of CDU 
that you requite. No documentation will he supplied. 

Please use appropriate packaging, cardboard stiffener al 
least, when returning disk. Do not send hack your 
magazine, only the disk please. 

NOTE: Do nol send your disks back to Ihe above address 
if il- ,i program thai does not appear to work. Only if the 
DISK i- f.iullv. Program faults should he sent to: BUG 
FINDERS, CDU, Alphavile Publications Ltd, Unit 20, 
Potters Lane, Kiln Farm, Milton Keynes, MK11 3HF. 
Thank you. 



4 



-ON THE DISK 



DISK DOCTOR 



mple utility to aid Disk Drive users brought to you by FERCAL MOANE 




effectively blank. Ihese two opitions 
provide a limited but irsLTtil archival 
system for your disks. Store Directory 
will read the directory track 01 a disk 



n another disk. Wher 
< blar 



UNSCRATCH FILE 

in you delete a file using the DOS SCRATCH 
mand, it is luckily mil erased from the disk. The 
i in the directory Irack corresponding to that file is 
ily marked as deleted and as such il is ignored by the 
i. Using this option allows you to recover a deleted 
provided you give the correct name. Unscratch file 
osl effective when used immediately after the delete 
ma rw I has been issued. This is bet ausr the undeleted 
"night be overwritten by other material, saved in the 
e occupied by the old file. 



CLOSE FILE 

If you use your Cu4 tor wordpruc.essirig, you will no 
doubt have experienced the loss of a file, usually that 
huge 10,000 word masterpiece! Perhaps a disk error or 
power cut happened when you were saving the tile, and 
only part of the file was saved. When you try to load the 
partially complete file you get error 60: WRITE FILE 
OPEN. This option allows the file to be closed properly 
and to be loaded back into the wordproi essor. It should 
work with all file types, but il is most effective with 
SEQUENTIAL FILES. 



STORE/RESTORE DIRECTORY 

You will probably be aware of the quick format 
command available on Commodore drives. It takes the 
form OPEN15,8,15,"NEW:diskname". Note how the ID 
is left out. Its function is to clear out the directory of an 
already formatted disk and is far taster than reformatting 
the entire disk. But what if you have cleared a disk with 



denta 

simple matter of using RESTORE 
DIRECTORY to put the correct 
directory track hark on the blank 
disk. Your files are resurrected! My 
advice is to use one disk for storage of all the directory 
(racks of your most important disks. Then when an 
ai i irlenlal lormat occurs, you can refer to the archive 
disk for their directory trai ks. Re m em her tu note the 
names lh.it you give Ihe files for each disk, this method 
iplions of Ihe directory track 



l:ltir. 



ring a 



direr lory would destroy [he i oriler'.ls of [he disk. Please 
note however that this option will NOT recover from a 
full format (including ID). With the long format 
command, the disk is actually erased and cannot be 
recovered. 



DISKETTE CHECKER 

This option allows you to examine the performance of 
the drive, the condition of a whole disk or track or a disk, 
DISK DOCTOR will check the disk and report back the 
number of any error that occurs. The main use of this 
oi.it ion is to ■: heck to see if disk- are ar tu.illv corrupt and 
to find the location of the error, DISK DOCTOR will try 
1 bad blocks, making si 



dai.i i 



3 these dodgy si 



e iha; 



lesl [he disk will he destroyed, so pled 



■be 



ID CHECKER 

When a disk is ID formatted, the ID number thai you 
give in Ihe iornvil i omnia nd is wriilen on eiery sector of 
the disk. If this track ID number is different from the disk 
ID, untold problems can occur. This is usually caused by 
swapping disk, between ,i write lo ihe disk and without 
initialising the new disk. This command will show up 
any incorrect IDs. Skilled people could use a DISK 
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ON THE DISK- 



ALIGNMENT ADJUSTER 



disk 

drive h.mdk-, .<-,id mi.. !: '.nil ■ k u, n s; n.j.in u ,-. ,,, 

il the disk is mil of ,il iginni-nl with 1 1n- disk head, chances 
in' lindinj; the i orri'i 1 lr.u k are immedi.iiely duuhled. Vnu 
may alsn specify Ihe number of lime- ih.il r ht- disk ilrin- 

■illfnipls the drive viiiikus. tin' lirllcc the ch.inces are of 
readinfl the disk correctly. This option will also remove 
the irritatinR 'WOODPECKER' noise when the drive head 
hits Ihe stop after a read error. Choosing this option isill 
reset the 64, allowing you to attempt to load your 
program. I have had considerable success in loading 
misaligned oi corrupted disks hut this is nol a miracle 
cure for clinically dead disks! 



DOS COMMANDS 

J- i i i.i Ik. ihis rt-jf simply iKludi'd In .ill m v.m (n f 
the directory, issue DOS commands and to che 
error channel of the drive. The RESTORE key will 
yon to Ihe main menu of DISK DOCTOR at an' 
Good luck in dealing with lud disk bluest 



TIMEWORKS SOFTWARE SALE 



VALUETIME PRODUCTS 



E3 



OFFICIAL DEALER FOR * COMMODORE 



COMPUTERS 
Amiga 1500 comprising : 
B2000+1 0B4S Monitor+Twin Floppies+ 
The Works! + Deluxe Paint 3+3 Games 
Amiga 500 SCREEN GEMS PACK 
comprising ; TV Modulator. 4 Games & 
Deluxe Paint 2 

Amiga 500 Basic Pack comprising : 
TV Modulator, Mouse, Workbench 1 .3, 
Extras Disk, Tutorial, Manuals 
Commodore 64C NIGHT MOVES Pack 
comprising ; Cassette Recorder, 8 Games 
K 2 Joysticks 

Commodore PC Starter Packs! AS SEEN ON TV ] 



Okimate 20 Print heads/Ribbons/Paper 

MONITORS 

Commodore 1084S Stereo Colour Mon 
Philips 8833-II Stereo Colour Monitor 
Philips 7502 Green Screen Monitor 



PRINTERS 

:en 1 20D+Parallel or Commodore 
LC-10 Parallel 
LC-200 Colour Parallel 
LC 24-10 24 pin Multi-tontl 70/57cps 



Amiga512KRAM/CIOCkBtptorA6O0.FreepSp. E 39.00 
Commodore 1541-11 Disk Drive £129.00 
Commodore C2N Data Recorder, p&p. £2 £ 29.95 
External 3.5" Disk Drive for Amiga pSp. £2 £ 59.95 
Power Supply for C64 p&p. £1 £ 26.95 

Supsr-G Parana! Intorface for C64/12B. p&p. £1 £ 34.95 
(Allows use of standard parallel printers on C 64/128 ) 
User Port Parallel Printer Cable p&p, £1 £ 15.99 

SOFTWARE 

Superbase64or128 Free p&p. £ 39.95 

Superscript 64 or 128 Free p&p. £ 39.95 

Tasword 64 40/80 Col WP-Tape or Disk.Free pSp. £ 24.95 

Mini Office II for64-Disk Free p&p. £ 19.95 

r 17.5% CARRIAGE £5 (EXPRESS £10) 

mange without notice 



Vdtei Pi Softcuaie Atd 



8 Ruswarp Lane, WHITBY, N. Yorks Y021 1 ND 
TEL/FAX: 0947 600065 (9am - 7pm| 
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ON THE DISK 



A stock management program for 
CI 28 users 
F.A.LATEGAN 




Every serious Commodore Disk User has some stock. 
Even ihe others have some experience of the slock 
market if they have played "THE FIRST MILLION', 
featured on Ihe February 1990 disk of CDU. If you own 
more lh.ni one stock in your portfolio, it beiontes soon 
impossible to really keep track of whal is happening lo 
your stocks. 

This program, SOLSTOCK.128 was developed for 
people like you. Suffer or Learn (SOL) Slocks' is for ihe 

To Load, switch on the computer with the 40/80 display 
key in the down position. Type RUN"SOL5TOCK.1 ->B~ 
and press RETURN. When prompted for the date, type it 
in any format which suits you, since it is only for your 
information on Ihe print-out. Alter hitlrng 'RETURN' the 
computer then loads "SOLSTOCK5.1 2.MC, the machine 
code for the pull-down menus. I used MENU MAKER 

128 by KICK GREGORY, published in a previous issue of 
CDU. Now that the system Is booted, it is time to set up 

TUTORIAL 

Use the cursor keys to move to NEW INFO. Press the 
down arrow or RETURN to select it. Press RETURN again 
to select NEW STOCK DATA. For our example, let's use 
ihe following data. 



300 Stocks 
1 0DD Slocks 
750 Stocks 
1 SOU Slocks 



II ENTERPRISES INC 
ABC INSURANCE 
COMMODORE INC 
CDU 

Type XXX lo end the input. 

Select first the CHANGE menu, then NEW PRICES. You 
will have to retype the date because, after the first time 
you don't have to retype all the slock info, lust reload the 
last stock data, and change the prices. (By loading the 
data, you also load the old date). Type the following 



J] ENTERPRISES INC 
ABC INSURANCE 
COMMODORE INC 
CDU 



DISK ■ Lets you Save, Load or Replace your stock. 

OUTPUT - This is used to view the portfolio. 

CHANGE - This is used to type in new prices, to change 
a price (to correct a typing mistake ior instance without 
r 1 't\|.nng til the prices), to change the number of stocks, 
to change a stock name, to change the date, to add 
another stock name and to delete a stock name, 

NEW INFO - This is used to compile a new stock 
portfolio. 

REORDER • This is used to order the stock names in 

.ilph.iln'iu ,il order. 
HELP ■ Gives a short help on all of the menu options, 
EXIT - This is used to leave the program. WARNING: if 

you have not saved you slo< k il.il.i. il will be lost. 



ADVANCED TUTORIAL 

Continue from Ihe tutorial with the same data. If you 
have erased it, enter il again as described in TUTORIAL. 

First of all, you have bought slock in a new company, 
ROBOTICS ALL. Select CHANGE, and ihen ADD 
STOCK. Enter the name, and the number of stock you 
have decided to buy (250 in this example). 

Next, you have sold all slock of ABC INSURANCE. 
Select CHANGE, and then DELETE STOCK. When ABC 
INM I RANGE is displayed, lype D' lo delete it. You have 
also boughl an additional 500 stocks of CDU. 5elect 
CHANGE, and then CHANGE NUMBER. When CDU 
appears, lype 2000, otherwise just type RETURN, 

Al this moment, ROBOTICS ALL's price is slill 0 since 
you have not yet typed in anything else. To repair this, 
select CHANGE, lullowed by CHANGE PRICE. Type 
RETURN until you get to ROBOTICS ALL, Enler the price 

Now select REORDER, and then ALPHABETICAL 
ORDER to order your slock alphabetically. Select 
OUTPUT, followed by SCREEN. 

Now select DISK, and then SAVE DATA lo save the 
configuration. Reload it using the LOAD DATA on the 
same menu. Select CHANGE, followed by NEW PRICES. 
Type the following prices; 

ABC INSURANCE 0.5 

CDU 63.03 

COMMODORE INC 27.33 

ROBOTICS ALL 12.B1 



OUTPUT and Ihen SCREEN lo see it on the screen, or 
PRINTER lo have a hardcopy, [Your printer must be 
device number -i. I have tested il on Ihe CBM801.801 
and the Seikosha SP-1 80VC1. Now for the other options. 
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ON THE DISK 



DISK SLEEVE PRINT 



A disk sleeve utility for those of us with NORMAL printers by STEVEN BURGESS 



lr yruir disk-In >\o .lie .is disori;,inised ,i- mine are then, 
like me, every lime you want to find a program yov 
probably have tti Vwidc through every unt ijI your disks 
and directory each one until you find your program 
which, almost invariably, is on the very las! disk you 
come to. Enter the answer. 
This progra 



ike a brand spanking n 




u-uhuiil mil- ur uridi'illnwinj;. You are then returned to 
the menu. 

Selecting the option PRINT OUT SLEEVE will cause 
the sleeve lo printout straight away so be sure to have 
the printer set up and some paper in it. The design uses 
line lull piet c ill printer paper. 

ALONG THE DOTTED LINE 

Once the sleeve has been printed and you have removed 
Ihe paper irom ihe printer and marvelled sufficiently at 
the sheer brilliance of this program, it is lime to cut it 
nut. You cut along the uuler edge ol the design. And then 



your disks. So, when you want lo lind ihe rlisk with your 
l.itesi blockbusting ( ompuier program on it you simply 
In k Ihmunh voi.ii box and. hey presto, vou have your 
disk. The advert over, lei's gel down lo business. 

THE PROGRAM 

When Ihe program ha- loaded and ii is nol lerrililv kjiiu, 
so it should only lake about half a minute, you are 
presented with a menu. 

The only option you can select at ihis moment is the 
option ENTER PROGRAM NAMES. Before selecting it, 
however, you must make sure lhat you have the disk, 
which you wish to creale a sleeve for, in the drive. Once 
done and drive switched on select the option. 

The screen will clear and then the name ol the disk 
will appear on Ihe screen. Then, one by one, the names 
of all the files will be printed and you will be asked 
which ones you wish to be printed on the sleeve. Be 
careful witli whit h ones you chose, though, because 
even files thai h.ive been deleted will appear. 

Once ihe enlire disk directory has been on ihe screen 
and you have selected which files will be on the sleeve 
you are asked to wait while the compuler formats the 
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16 Connaught Street, 
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A DVENTURING 

memve mm 

The ASTRODUS AFFAIR gets another airing by JASON FINCH 



So the merry month of May is upon us and I will 
be Hiving nothing away if I tell you that by the end 
of this article you will be on the very edge of 
being able to complete Ihe excellent adventure 
published by CDU last year, THE ASTRODUS 
AFFAIR. Last month I finished by explaining how 
to repair the hole that was causing a few problems 
and this month I shall explain where you go from 
there, including the problem of the stabilization 
chamber and how to get from the top level to the 
bottom. I shall leave telling you how to replace 
the fuses in the crafts drive so that you can fulfil 
all of ihe conditions that allow you to finish the 
adventure until next month. Those being having 
the generator on, the fuses in the engine room 
repaired/replaced, the stabalization chamber 
•aclive', the hole in the corridor repaired, the 
button pressed for navigation and finally the 
correct use of Ihe code 'XX2V. The format is the 
same as that for previous articles, a general 
outline of the method for obtaining the solution to 
a certain problem, followed by a section detailing 
the systematic way about things. Also in lune 1 
shall provide you with a full map of the Astrodus - 
Editor permitting, that is! So, let the Astrodus slide 
once again under the microscope... 



THE WALL OF OXYGEN 

The way into the stabalization chamber is blocked 
by a wall of oxygen that is leaking from a ruptured 
pipe. Of course you won't have discovered the 
chamber yet if you haven't solved this problem, so 
it is probably wise to cover this first. Once you 
have repaired the hole, though, you need to set up 
some situations ready for later on, First you must 
drop the globe again and go and switch the power 
off. This will enable you to return and move the 
globe to the location immediately east of where it 
was. Then go and put the power back on. The 
globe will be free to move around so long as you 
keep out of locations 12 and 15. If you don't then 
not only will the globe be immobilised, so will 
your attempts at finishing the advenlurel You need 
to then go to cross-section B and collect the infra- 
red grenade It is not intended for consumption by 
you or drygars so don't try feeding it to one of 
them! It will only result in you being covered by 
"MURling drygar meat" with the rest of the bunch 
soon making short work of you. The grenade is 



intended to be thrown at the wall of oxygen in 
location 4. Then you can return to where you 
deposited the globe. Skip the next section if you 
don't require further assistance with that problem. 



BREAKING THE BARRIER 

Once the hole is repaired, DROP the GLOBE and 
go WEST and then SOUTH. Turn the power off by 
PRFS^ing A51X, Return NORTH and then EA5T. 
GET the GLOBE and go EA5T again. Now DROP 
Ihe GLOBE and go WEST, WEST and SOUTH. 
PRESS A51X a final lime to switch the power back 
on and go NORTH, EAST and EAST again. The 
globe \s tree to move elsewhere. Now go SOUTH 
and DOWN the staircase. GET the GRENADE and 
be careful! Go UP, NORTH, EAST, UP another 
flight of stairs and then SOUTH, and SOUTH 
again to location 4. THROW the GRENADE and 
the oxygen will be ignited. Vou are then free to go 
east to the stabalization chamber. However, before 
you do that, return to the globe by moving, 
NORTH, NORTH, DOWN and WEST. 



THE CHAMBER PROBLEM 

I bet you haven't got the rope, have your Well first 
things first - you must get the rope which is 
probably still in the supplies room, return to the 
jilolir. take it and then tie the rope to it. You can 
then go the stabalization chamber. The globe will 
be attracted to a point above the silver disc at the 
base of the chamber. Because the rope is tied to it, 
and the rope dangles against the side of the 
platform on which you are standing, you can 
simply i:limb down it to the bottom. That way you 
avoid such pleasant messages as "the floor ... 
races cheerfully towards you with a squelchy 
thud"! To find out exactly what to do, read on; 
otherw^e skip to the section labelled CONSOLE 
QUERIES. 



GETTING TO THE BOTTOM 

If you don't have the rope, go to the supplies 
room by moving SOUTH, DOWN and WEST. GET 
the ROPE and go back EAST, UP and NORTH. 
Now GET the GLOBE and TIE the ROPE TO the 
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ADVENTURING 



GLOBE. Now make your way EAST, UP the 
staircase and then SOUTH and SOUTH again. 
Seeing as how you are free id go east now. do 
just that - CO EAST. The globe should be 
attracted over the disc and you will be told that 
rather than dangle precariously from the roof of 
the chamber, you drop off onto the platform. The 
observant will notice thai "the rope dangles 
down..., swinging idly against the platform 
that isn't a cue to enter DOWN, then I d 
know what is! 



closes and if you were in location 24 you wou 
be told that the chamber was 'active'. One mo 
piece of the puzzle falls into place. Ignore tl 
next section if you don't want to spoil the fun! 



EXAMINE the small black CONSOLE and then 
If PULL its EDGES. When it has dropped into your 
't hand, go UP and then WEST. Now PRESS the 
BUTTON. That was a bit simple wasn't it. 



CONSOLE QUERIES 

t the bottom you should be informed that 
I a black console set into the wall. Upon 
lation you should be [old that all 



perfectly 

So rio^il! 
played or 

does. If you 
why being 
rising Iowa 
Make sure 

You will th 



the 



The 



jral thing to do I?), would be 
i wait for it to plop ink) your hand, 
t the writer of the adventure has 
iur curiosity here because everyone 
■ know what the little red button 
press it then you will find out just 
pressed against a wall with the floor 
ds the ceiling isn't really a lot of fun. 
hat you are out of the chamber and 
befote you press the button, 
ice that the chamber door 



THE END ALREADY 

No, not the end of the adventure - the end of 
this month's offering of help. You have learned a 
number of things hopefully and next month we 
will look at the final problems. Incidentally, 
23 utile 



I More 



ihoul lhat i 



:. All V 



lo do is open the safe, retrieve the fuses a 
them in the engine room. Then it's hey presto 
and onto another adventure in this long running 
quest to provide help. Which would you prefer - 
Runaway or the Cranmore Diamond Caper? Do 
please lei me know! Have fun trying to solve this 
month's adventures and until thirty odd days 
have elapsed, see yer! 



MSJO Of MS/C 



s of Basic lutoriiils designed to make the beginner an expert 
JOHN SIMPSON 



IMPORTANT ANNOUNCEMENT - Due to unforeseen 
technical problems, and the fact the your illustrious 
Editor is a bit of a wally, we inadvertently missed out 
the start of section two of this series in the MARCH 
issue of the magazine. Therefore, before this months 
offering gets underway, we present the missing piece for 
your enjoyment. 



COMMENCEMENT OF PART TWO 

Let us begin this session by (irsl writing a small program 
which wnl allow us in the compulei to rcqueM some 
input of numbers which we can then manipulate and 
finally display a result. 

Remember to press the return key <CR> after you have 
typed in each line. 



10 INPUT-FIRST NUMBER";FIRST <CR> 
20 INPUr'SECOND NUMBER";SEC <CR> 
JO LET SUM = FIRST + SEC <:CR> 
40 PRINT"THE RESULT IS"SUM <CR> 
50 END 

Once you have typed in the program, let's refresh our 
memory ni Hearing ihe screen and listing J program 
from the last session (part 1 ), 



We shall now make ihe computer execute our program 
by typing, RUN <CR>. 

As Soon as you do this the computer will respond by 
printing on a new line below RUN, 
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FIRST NUMBER? (and a flashing cursor) 

You are being prompted | ( > type in a number. Should you 
type in s letter, or a series of letters, or even numbers and 
letters, then (he I omputer will respond with: 

{REDO FROM THE START 

This shows you thai it is able lo distinguish between a 
number and something else (we'll discuss (his more 
closely in a short while). 

Should you perform a <CR> without typing a number ihe 
computer will fill the variable, FIRST, with the default 
value of zero, and then continue lo the next line of ihe 
program, the screen will now display: 

SECOND NUMBER! [Cursor] 

Type in the second number cCRs, and ihe computer will 
respond by displaying on the screen: 

THE RESULT IS [first + sec] 

READY 

Let us examine more closely whal has taken place. In 
line 10 we used ihe Keyword INPUT. This is a command 
lo tell the computer lo expect the user to enter somelhing 
Irom the keyboard, and lo stote il in Ihe varublc labelled 

FIRST. 

You will have noticed thai Ihe keyword INPUT can also 
be used lo print information lo the screen. The 
information, like the PRINT command's output, being 
enclosed wilhin quotes Make note of the semicolon 
fc] following Ihe final quote, and before ihe label, FIRST. 
This is important. Without it Ihe computer will display a 



THE SCREEN EDITOR 

The c ursor tan be directed .liouud Ihe screen by using a 
combinalion of the SHIFT key and the cursor keys. The 
cursor keys are the two keys nexl lo ihe right SHIFT key 
and marked (. KSK with up/down leil/rigbl arrows. To 
move Ihe cursor down the screen use the cursor 
'up/down' key, and lo move up the screen hold down a 
SHIFT key together with Ihe same key. To move Ihe 
cursor righl use ihe cursor -left/right' key, and lo move 
k-lt hold clown .1 SHIf T kev together with the same key. 

To edit a part of ihe program move Ihe cursor up to line 
10. and ..long Ihe line lo Ihe F in FIRST Now tap ihe 
INST/DEL key al lop right, and the label FIRST will shift 
lo the left, deleting ihe semicolon. Press <CR>. 

You have just used the screen editor. Whenever you do 
use this editor lo make changes lo a line, always 
remember lo press relurn lo enter the changes into the 
program. 



We have jusl deleted a piece of program code, namely 
the semicolon, bul we can just as easily insert code by 
holding down ihe SHIh r Key and lapping ihe INST/DEL 
key which will shirt the code to the right opening up a 
Space lor you to enter new code. Move back to the F in 
FIRST and try this, Ihen type the semicolon back in and 

II you run through ihe deletion of ihe semicolon once 
more, ihen RUN the program (first ensuring thai you 
move the cursor back down ihe screen to a clear line). 
The compuler will respond by displaying a syntax error 
message, however, unlike the message which was printed 
in pari one, where we used a DIRECT COMMAND (his 
error will actually print Ihe line number in which the 
error occurs. In our ease ihe message will read: 

? SYNTAX ERROR IN 10 
READY 

You can use the screen editor quite freely lo edit a 
program, i.e. add code, and delete code. If you find ihe 
need to delete a whole line, all that is required is lo type 
Ihe line number, on a new line, followed by <CR>. Let's 
try this by deleting line 50 in our program: 

SO <CR> 

Now LIST the program and hey presto! line 5(1 has gone. 
If you decide that you warn 10 get rid of Ihe entire 
program, Ihis can be done by typing a Direcl Command 
(i.e. no line numberl, namely: 

NEW <CR> 

Try this. Now we have jusl deleted our program. This is 
■i useful command, bul one fraught with danger for when 
you do NEW a program, it has gone for good! Try LIST 
and you will just receive: READY. The program has 
gone - with no way to retrieve It. 

STRING INPUT 

We have jusl seen that we can easily force Ihe user to 
input numbers, albeil only two at a time in Ihe foregoing 
program, although if you warned lo place more INPUT 
commands plus variable labels you can do so. 

We touched briefly on [he term strings, earlier in Part 1 , 
bul now we shall look inlo them in more detail, A siring 
is a group of alphanumeric characters contained within a 
pair of quotes: 

"THIS IS A STRING" 

"AND SO TO IS THIS ABCD1234" 

"1 234567890" is also a string 

How long can a string be? Well CFJM basic does allow 
for up to 256 characters, bul their is a limitation on a 
basic line length of 80 characters, and this will include 
ihe line number and statements, so for the lime being we 
will restrict ourselves to 40 characters. Laier we will 
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To distinguish between a numerical input, as used earlier, 
and ,1 siring input the dollar jign ( $ ) is utilised. For the 
numerical input we simply type in a label, such as we 
did earlier with FIRST. SEC. and SUM. Simply by having 
no 'prefix', the computer understands that it is dealing 
with numbers. The string input, however, is prefixed wilh 
a dollar ( S ) sign. Right, lei's write a small program 
which will demonstrate this by imputing string 



10 INPUT'YOUR NAME PLEASE"; NS 

20 INPUT'YOUR ADDRESS PLEASE";AS 

30 INPUT"YOIJR TELEPHONE NUMBER PIEASE";T$ 

40 PRINT CHR$(147) 

50 PRINT NS 

60 PRINT A$ 

70 PRINT TS 

80 END 

When you RUN this program you will be asked to type 
in your name, spaces are allowed, and as before when 
you have typed in your input this is entered by pressing 
<CR>. Next you will be asked to type in your address, 
followed by your telephone number. 

Before we examine line 40 you may have received a 
message which stated: 

i EXTRA IGNORED 

If you did, then by examining the printed output you will 
sen lhat everything that iol lowed the character which 
preceded the comma which you typed has not been 
printed. What this tells us, loosely, is that CBM Basic 
will not accept a comma emp laced within a string, and 
will thus terminate any output including the comma 
onwards. 

Line 40 is a special command, CHRt(147). which tells 
the computer to clear the screen - the same as you did 
when you used fhe SHIFT key and INST/DEL key. There 
are a lot of numbers we can use within ihe brackets of 
CHRJIni to tell the computer to do many things, 
however, that is for later. 

The computer will create two storage areas, one is used 
for variables and constants, and the other is used for 
holding strings. 

With strings, the same as variables, the maximum length 
of a label is two characters although more can he used 
for information purposes. I used NS for the name, this 
could just as easily have been NAMES, however, wilh 
NA being the significant portion of the label. Note also 
the prefix of S. 

to let the computer know it is dealing with a string of 
characters, 

ANOTHER GLANCE AT VARIABLES 
AND STRINGS 



As well as using INPUT statements to assign a variable or 
a string to a label, they can also be assigned using the 
LET statement: 

10 LET A = 10 
20 LET B = 1000 

30 LET AS = "THIS IS A STRING" 
40 LET BS = "ABC 123X": REM - A CAR NUMBER PLATE. 

If somewhere else in the program you state: 

100 PRINT B / A 
110 PRINT AS 
120 PRINT BS 

I'm sure you can work out the result! (Remember that 
the [ / ) symbol = division). 



MULTIPLE STATEMENTS 

On line 40 in the program lines above and alter the string 
"ABC 123X", and before Ihe REMark I placed a colon ( : 
). The purpose of the colon is to separate statements 
which are on the same line, it's as though you have 
started a new line, but without a line number. It means 
the same as this: 

40 LET BS = "ABC 123X" 

50 REM - A CAR NUMBER PLATE 

We are allowed to place as many statements as we can 
upon each line so long as they are separated by colons. 
This does have the advantage of freeing up some 
memory, but it often has the disadvantage ot making 
programs more difficult to follow, and, more impm i.r'.ily 

Ihi'imelves. We will discover these particular instances 
as we come to them in the lessons. 
However, to round off multiple statements hete is an 
example of multiple statement lines of code: 

10 LET X = 34 : LET Y = 72 : PRINT X : PRINT Y 

20 LET NS = "VOUR NAME" : LET A$ = "YOUR ADDRESS" 

30 INPUT MS : INPUT A1$: PRINT NIS : PRINT Alt 



OUR FIRST LOOP 

Ofttimes it is extremely useful to get the program to run 
around a loop - as an example of a need for this is a 
delay loop, where you wish to slow down the program 
e\ei ution mi tome reason There arc lwn basil methods- 
available and the first of these is called a FOR. ..NEXT 

Type NEW then <CLR> (i.e. clear the screen], then type 
in Ihe following program: 

10 PRINT "HELLO" 
20 FORX = 1 TO 1000 

25 REM - A DUMMY LINE TO DEMONSTRATE THE 
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LOOP 

30 NEXT X 

4(1 PRINT "WORLD" 

50 END 

When you run (his program, first HELLO is printed, then 
■i lengthy delay where, on (he following line, WORLD is 

Wlut we have dune here is to set up a variable called X 
and have given il an initial value of 1 . FOR X = 1 ... We 
have also established that the value of X will not 
increment above 1000. ...TO 1000. When (he program 
steps through to (he line 30, NEXT X, i( will check the 
value of X and if it is not greater than 1000 then it will 
jump backwards to the statement following the FOR ... 
statement, in our case, line 25 which was a REM placed 
there to create a line which ac(ually does nothing of 
importance. In a more complex program (he distance 
between (he FOR and the NEXT could be quite large with 
several stiilemi-nis beini: executed ■'" between. Lei's have 
a look at a simple example of this: 

10 LET AS = "THE VALUE OF X IS" 
20 FOR X - 1 TO 10 
30 PRINT A$ X 

40 FOR V = 1 TO 1000:NEXT Y 
50 NEXT X 
60 END 

Now if you KLIN this program it will print ten lines, each 
one telling you what the current value of X is. You will 
also observe (hat we have place one FOR. ..NEXT loop 
inside another, creating two statements on one line. This 
is known as 'nesting'. The outer X loop, iterates ten limes 
printing the message of A$, and the inner Y loop acts as a 
delay, '.lowing things down. The outer loop will iterate 
once, then the inner loop will iterate 1000 limes before 
the outer loop iterates again. So the inner loop will 
iterate 10 x 1000 times. 

The other basic method for a controlled loop is to set up 
a variable, increment the variable and tesl il to Mnd out if 
it has reached a predeter mined level, if it has then exit 
from the loop. Now if this does sound similar to the 
FOR. ..NEXT loop, then in essence it is, except with this 
loop we must determine what action to lake upon each 
iteration. This will require decision making. 



MAKING DECISIONS 

The more common method of decision making is to use 
the command statements IF.. .THEN. In other words, IF 
this is true, THEN do something, olhcru im- do something 
else. Forexample, START ■ IF X = 10 THEN X = 0 AND 
END, OTHERWISE X = X + 1 GO BACK TO START. 

We will now create another, but smaller, delay loop to 
demonstrate the technique: 

10 LET I = 1 
20 PRINT I 



30 LET 1 = 1 + 1 
40 IF I =< 10 THEN 20 
50 PRINT "DONE" 
60 END 

If you run this program it will print the digits from 1 to 
10, followed with DONE. But what is actually taking 

line 10 initialises a variable labelled I to equal 1. 
line 20 immediately prints its value, 
line 30 increments I by one. 

line 40 evaluates whether I is equal to, or less than, ten 
(the symbol =< means equal to or less than), and if it is 
will send the computer back to line 20 (THEN 20 means 
goto 20). The computer will loop between lines 20 and 
40 until the value of I is greater than ten where it will not 
goto line 20. hut drop through to line 50, which simply 
prints DOME, and the program terminates. 

Whether we use the FOR... NEXT loop, or a decision 
making branch, IF... THEN will very much depend upon 
the program we are working on. This Is where 
experience, and knowledge combine, knowing which 
method best to use, and this you will gain as we progress 
through our subject lessons. 



FINALLY, LET'S GET RID OF LET 

I have been using the word LET each time I assigned a 
value, or a string to a label. Although LET is a keyword, 
il is optional whether you wish to use it. Sometimes ; : 
can make the understanding of a program more clear, but 
mostly it just uses up a little mure mumurv anil e\ei ulion 
time. It is up to you whether you wish to use it, but we 
can slate: 

10 X = 10 

20 AS = "LET CO" 

30 A = A+B/C'D 

40 FIRST = 1: SEC = 2 



SUMMARY FOR PART TWO 

1. In this session we discovered that by using the 
keyword INPUT the computer can request the user to 
enter numbers which can then be used to either initialise 
variables or perform mathematical manipulations upon 
them. 

2. We also discovered that the computer can judge the 
difference between numbers and strings of alphanumeric 
characters. 

3. We saw that we can use the facilities of the screen 
editor to make changes to our code, either rl tiding 
and/or inserting the changes which may be required. 
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4. We looked into the INPUT of char, icier string--, how 
we can program the computer to request information 
such as names and addresses, telephone numbers, ScPtc, 
by using the prefix S character. We also noted the 
limit jtum hi using the i omnia u ithin a string; where the 
levt following the comma will be ignored. 

5. We also noterl that strings tan be up to 25b characters, 
in length, but, because of line restrictions, we have 
temporary limited the length to 4(1 characters until later 
in the series where we will discover the method to 
overcome this restriction. 



6. Part of this 



7. By using a 
statements on ; 
when using this 



showed that 



also 



We shall now look at methods to control character 
colour, cursor positioning, and formatting. The first two, 
character colour and cursor positioning use a method of 
einlvrlding within tt-vt .tnngs the necessary 'shorthand' 
commands to perform such functions. 

Formatting has the use of two possible keywords, 
namely, TABIi and SPCO, we shall deal with these in a 
moment. However, there are other methods for 
positioning the cursor. One of which which uses a 
machine code routine within the operating system know 
as 'PLOT, and yet another method which will allow us 
to save the current cursor position before we move it to 
another screen location, then retrieve it to move back 
again. We can also use the embedded cursor controls 
held in strings which can then be manipulated by 



r test, or borders, 
t, and even quite 



can be omitted. 

That's jus! about it. We apologise for missing out all of 
the above, we hope that it did not confuse you too 
much. Before getting on with this months tutorial 
proper, we have added a little footnote to finish off 
MARCH'S discussion on ARRAYS. 



) rontnr 



) the din 



ing oi 



■f air 



EMBEDDED COMMANDS 

The thing about using embedded i onim.nids within lent 
strings is that I will have to use abbreviations to let you 
know what it is I want you to do. Remember last month 
I told you about performing the screen clear by using the 
SHIFT and CLR/HOME keys in conjunction, i.e. 

10 PRINT "[SHIFT C LR/ H OM E|CLE AR I NG THE SCREEN" 

using this method printed a reversed heart symbol, Here 
follows a list of the abbreviations for the embedded 
commands which I shall be using throughout the series. 



10DIMNAMES(1t»,SCORESt10),AAi100i,BB(10,6),MN$(2,2) 
will separately dimension NAMES - SCORES - AA - BB - 
NN$ 



1MB. Some of the programs and program segments in the 

suggested that you do write the smaller segments 
vourseli. but it you should liiwl things J little Kit k\ then 
you can load in from the disk. The programs which are 
on the disk will be preceded by their save name just 
before the tutorial listing. These are BB.EG#<n>, where 
n is the example number. 



COLOUR, FORMAT, AND 
GRAPHICS 



ABBREV KEYPRESS REQUIRED 

[CR] CRSR LEFT/RIGHT KEY 

[CI] SHIFT AND CRSR IEFT/RIGHT KEYS 

[CD] CRSR UP/DOWN KEY 

[CU] SHIFT AND CRSR UP/DOWN KEYS 

A number following the cursor controls means press the 
key that particular number of times. E.G. ICRS! = CRSR 
LEFT/RIGHT key five times. 



[HOME] 
[CIR] 
[RVSON] 
[RVSOFF] 
[INST] 
[DEL] 
[PI] 



CLR/HOME KEY 
SHIFT AND CLR/HOME KEYS 
CTRL AND 9 KEYS 
CTRL AND 0 KEYS 
INST/DEL KEY 
SHIFT AND INST/DEl KEYS 
SHIFT AND UP ARROW KEYS 
[LARROW] LEFT ARROW KEY 
[UPARROW] UP ARROW KEY 
[SPAC] SPACE-BAR 
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wing the space bar means press (ti- 
mber (if limes. E.G. ISPAC10] = Space 
ating ten blank spaces. 



COLOURS 

[BLACK] 

[WHITE] 

[RED] 

[CYAN] 

[PURPLE] 

[GREEN] 

[BLUE] 

[YELLOW] 

[ORANGE] 

[BROWN] 

[LRED] 

[CREY1I 

[GREY2] 

[LGREEN] 

[LBLUE] 

[GREY3] 



CTRL A 
CTRL A 
CTRL A 
CTRL A 
CTRL A 



ND 1 KEYS 
ND 2 KEYS 
ND 3 KEYS 
ND 4 KEYS 
ND 5 KEYS 
CTRL AND 6 KEYS 
CTRL AND 7 KEYS 
CTRL AND 8 KEYS 
CBM AND 1 KEYS 
CBM AND 2 KEYS 
CBM AND 3 KEYS 
CBM AND 4 KEYS 
CBM AND S KEYS 
CBM AND 6 KEYS 
CBM AND 7 KEYS 
CBM AND 8 KEYS 
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A number following the C/LETTEK UK S/LETTLK means 
press the letter key that particular number of limns. E.G. 
[S/F8I = hold SHIFT down and press the letter F eight 



Using these abbreviation; 
to call them), we can now choose to add colour to o 
printed output, or move the cursor up, down, lefl at 
right, or by using the special graphic symbols crea 
some neat graphic eflects. Let's have a look at a fe 
examples of what I mean. 

BB.EG#1 

5 REM COLOUR AND CURSOR CHANGES *** 

10 PRINT"[CLR][LGREEN]CLEAR THE SCREEN AND 

COLOURS LIGHT GREEN" 

20 PRINT"[CD4][LRED]THIS TEXT HAS MOVED 
DOWN FOUR LINES" 

30 PRINT"[CU3][GREY3]TEXT HAS CHANGED 
COLOUR AND MOVED UP" 

40 PRINT"[CD4]A MULTICOLORED |LRED]W[WHITE] 
0[CREEN]R[YELLOW]D" 

SO PRINT"[LBLUEl[CD2]COLOUR BACK TO 
NORMAL" 



hi l hi-, f*\,ini!jli-' I h .vi' n irku eri ,i iih» < onmiand ivord 
in line 50, namely, GET, Let us divert our attenlion for a 
moment and examine this more closely; programmers 
tend to use this key word quite a lot. 

A method whereby ihe Computer is able to delect when 
a user makes a keypress is to employ a system \\ hit li will 
continually c heck the keyboard lo see if a key has been 
pressed. Obviously ihe i ompuier is di ling Ibis c imsl.inlly 
from the moment ii is swilched on. However, we can use 
the key word GET to find out what was the very last 
keypress a user might have made and then put this 
inrormalion lo oui own use. Bui ausc Ihe keyboard is .ill 
characters (i.e. letters, numbers, and controls}, then we 
need to use a string variable to store the value of last 
keypress. 

In the program above I chose to use the string variable 
A$. GET will place the last key press inlo Ihe variable 
AS. Now if no key has been pressed then AS is filled 
with the string equivalent of zero, which is referred to as 
a 'null' string. As you know by using quotes allows the 
machine to idenlily tin- beginning and ihe ending oi a 
string of characters. This, " ", tor example, means a 
string of a single space, and this, "Z", means a string 
which contains only the letter Z. A null string is 
represented thus, "". 

So, line 50 uses GET and places the result in the vadable 
A$. The next command on line 50 is an IF.. .THEN 
decision. If AS = "" THEN 50, in other words if AS is 
null then no key has been pressed so go to line 50 and 
use GET again. The program will loop forever on line iiO 
until a key has been pressed. Orn v a kev is pressed Ihrn 
A$ will hold a value other than null, therefore, the 
decision argument becomes false and so ihe ...THEN pari 
of Ihe argument will not be executed which means the 
program will 'drop through' line 50 and continue to 



efrom line 60. 



hold ihe 
readily bet 



:r the foregoing you will realise that AS will 
e of the character which was pressed. It 
Ties apparent that you can have a much 



from what the keypress might have been. For example , 
few IF.. .THEN del isions i ould dclermine if the key was i 
"Y" for Yes, or an "N" for No, or whatever. We will b 
returning to this quite soon. 



BB.EG#2 

5 REM — A LOOK AT REVERSE VIDEO — 
1 0 PRlNT"[CLR][CD4][LRED][RVSON][SPAC2]A 
TITLE/MENU BAR[SPAC2][RVSOFF] 
20 PRINT"[WHITE][CD]1. MENU ITEM 1" 
30 PRINT"2. MENU ITEM 2" 

40 PRINT"[CD12][CYAN][RVSON][SPAC]PRESS ANY 
KEY TO QUIT[SPAC][RVSOFF]" 



BB.EG#3 

5 REM — GRAPHIC SYMBOL5 EXAMPLE *•" 

10 PRINT"[CLR][CD8][CR7][BLACK][S/0][C/Y24][S/P]" 

20 PRINT"[CR7l[C/H]|YELLOW]THI5 COULD BE A 

DIALOGUES LACK] [C/N]" 

30 PRINT"[CR7][C/H][SPAC24][C/N" 

40 PRINT"[CR7][C/H][GREEN][SPAC9]BOX...[SPAC9][ 
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BLACK] [C/N]" 

50 PRINTiCR7][C/H][SPAC24][C/N" 

60 PRINT"[CR7][S/L][C/P24][S/@|[LBLUE]" 

Al first sight (his may seem a little cryptic, but by 

v.houkln'1 prove toci much of a hassle. Note also that line 
50 is identical to line .10. trie re ion:. instead ol typing in 
line 50 simply cursor up to line 30 ant) replace the 3 with 
a 5 (remember to press return, and then move the rursor 
bat k down the screen to a blank space ready to type in 
line 601. When you have linished typing in this example 
and have RUN it, then the screen should be cleared and 
j box with the words, THIS COULD BE A DIALOGUE 
BOX,., within it should appear onto the screen. 

If you practice using the embedded controls and the 
graphic symbols by simply 'playing around' with them 
using the print command you will soon commit all the 
necessary controls and commands to memory. It really is 



FORMAT WITH TAB AND SPC 

The action of the SPC function is to control the iormatting 
ol data as either an output to the screen or to a logual 
file. However, at this stage we shall only look at the 
screen function. We can tell the computer how many 
spaces we require the cursor to move by enclosing the 
number of sp.ices required in patent he-sis. The number rif 
the argument [spaced must be in the range from 0 to 255. 

10 PRINT"WE CAN PRINT HERE"; 
20 PRINT SPC(10)"AND THERE" 
RUN 

WE CAN PRINT HERE AND THERE 

READY. 

From this example you will see that the spaces (10) are 
counted from the end of HERE to the beginning of AND. 
Also in this example you will have noted the use of a 
semi-rolon at the end of line 10. This tells ihe lompuler 
not to perform a carriage return after it has finished 
prinimg i he text uf line 10. so. therefore, the next prinl 
statement iline 20i will lonlinue printing it's text upon 
the same line. This will indeed prove to be a very useful 

10PR1NT"ONE"SPCI10)"TWO"SPC(8)"THREE" 
RUN 

ONE TWO THREE 
READY. 



The ,ii tion of the TAB function, although it may at first 

position on the screen given hy a numeric argument in 
parenthesis but this time starting at the left-most position 
of the current screen line. Once again the numeric 
argument is in the range from o to 255. 



10 PRINT"NAME" TAB(30| "AMOUNT":PRINT 

20 PRINT"JOHN" TAB(32) "50" 

RUN 

NAME AMOUNT 
JOHN 50 
READY. 

From this example you can see that the tabulation was 
from the start of the line. It counted over both NAME, 
and |OHN. Whereas the SPC command counted from the 
point where the cursor was currently situated. You can 
also see that at the end of line 10 I added a second 
PRINT statement on its own. What this achieves is to 
print a carriage return, wr.ii h i;ives a row space between 
the line, NAME AMOUNT and the line, |OHN 50. 

10 PRINT"HELLO"TAB(85)"THERE" 

RUN 

HELLO 

THERE 

READY. 

That is all for now concerning Tabulation, Embedded 
Controls, and Graphic keys. You can create your own 
homework!!!, and simply play around with the things we 
have covered so far. You cannot harm the compuler, and 
if anything should go wrong with a program you may 
create and the system 'bombs' out, simply switch off, 



POKING AND PEEKING 

That subtitle almost sounds as though it could be some 
exotic Chinese dish! 

To POKE means to place a value into a memory location. 
To PEEK means to have a look at a memory location and 
find out what value it may contain. Of course to either 
POKt or I'ttK a memory location will require you to 
know the address of the memory location you wish to 
deal with. 

tarlier I explained that the compuler has 65,5.)h bytes oi 
memory, ear h byle representing ,i memory location, and. 
each byte can only hold a number from 0 to 255. The 
computer's memory 'mapped' into various areas and 
segitients for better memory management, There are 
areas in this map which will prove to be of great 
importance to you as you establish you programming 
skills, fall el. sets oul a very generalised memory map. 

1 1 you have the (."nmmorlore M L.ser Mjnui.il which came 
with the Commodore when it was purchased, then by 
turning lo page l ■! i you will find Appendix E, which is a 
list of the SCREEN DISPLAY CODES. For the time being 
we shall ignore SET 2 and concentrate on SET I. You 
will see that a character is displayed under the SET 1 
heading and a number under Ihe POKE heading. What 
all of this means, in actual fact, is that if we POKE the 
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value of the character we require, say 1 for the letter A, 
into an address of the screen area isee Table 1 ). then that 
letter will he reproduced onto the screen. 

Now if you turn to page 149 of the manual you will 
discover a pictorial representation of the screen which 
lisls .ill the memory addresses. Vou can see [hat the 
screen is divided into 1000 character squares in a matrix 
til 40 squares In iri7onlallv by J:> squares vertically. We 
usually refer to this as X (columns - 40) by Y [rows - 25). 
The start address, commonly referred to as ihe Screen 
Base Address is memory location 1024. Study the screen 
memory map on page 149 for a moment and all of this 
becomes quite clear. 



\= 12B+1 = 129. 



POKING COLOUR 

The screen we have just been looking at is the character 
screen. To use colour changes we must now access 
another screen, ihis is located in a different part of the 
Memory Map. The Colour Memory Map (or screen) Base 
Address is located at 55296. Once again this is a matrix 
of 40 it 25 squares (1000), and you will find a pictorial 
representation of this located on page 150 of the User 
Manual. Table 2. lists the values needed to POKE a 
i olour inlo Ihe Colour Map. So: 



So n 



i the 



When you run ihis you will see that the letter A has been 
printed into the first character square. So, the POKE 
statement is saying to the computer take the value of 1, 
which happens lo be the screen code for the letter A, and 
place it into the 1 .024th byte in the computer's memory. 
Nothing could be more simple, ehf 

We can, using that which we have so far learned, do 
much more than this, let's print a whole string of the 
letter A. Here we will need a loop lo iterate around our 
POKE statement. Try this: 



POKING SCREEN AND BORDER 
COLOURS 



rally we do not wish I 
Start-up screen and border 
might like to change the 
quite often in a program t 
things. We might even v 
indicate something by all 



and border colour 
to the aesthetics of 

use the border to 
it to cycle through 



10 FOKX = 0 TO 999 
20 POKE 1024 + X,1 
30 NEXT X 

When you run this program you will see that it will quile 
rapidly (ill Ihe screen with letter A's. You can see that in 
line 20 we simply add the value of X to 1024, thereby 
Incrementing it by one character square each iteration at 
the loop. 

With slight moditi 
to actually list the 
Clear the; 

10 PRINT"[CtR][CDB]" 
20 FORX = 0TO25S 
30 POKE 1024 + X,X 
40 NEXT X 



There are two memory locations which will alow 
to do such things as I have just described. They ai 
address 532B0 for the border colour and addre 
S32H1 (or the screen colour. Using Ihe colour valu 
as defined in Table 2. we can now POKE a colour 
one, or both of these locations. 

10 POKE 53280,0 : POKE 53281,0 



After you have RUN this program you will see a 
possible i haracteis i2.%) of the set printed on the screen. 
The first 12K characters are in normal video and the next 
I 2H characters are irlentii .i evcept Ihey are the reversed 
video characters. This tells you thai when you actually 
use Ihe HVS/ON command Ihe computer simply adds (be 
value of 128 lo the character values in the character 
string of Ihe PRINT stalement. I.E. the letter A = 1 and Ihe 



20 FOR X = 0 TO 64 : POKE 53280.X : NEXT X 

and the border will cycle through all 16 colours four 
times. Useful if you need lo catch Ihe attention of the 
user of your program. 

Using the screen colour in conjunction with character 
colours can bring your screens alive and make even 

adventurous. 



LOOKING AT BYTES - PEEKING 
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wish to look into a memory location 10 find 
<alue is being held their we use the PEEK 
or keyword. We must efldOM the address 
■ brackets. For example, PRINT PEEKI532B0) will 
the current colour of the border. Amending the 
.pie border cycle above we could interrupt the 
on any given colour and print a message: 



20 FOR X = 0 TO 64 : POKE 53280.X 
30 IF PEEK(53280)=247 THEN PRINT'YELLOW" 
40 NEXT X 

You will quickly spot that I have used the value of 147 
instead of 7. Why? 

Remember. ,i bvte is eight hits, xxxx xxxx which is 
four low bits and four high bits looking from right lo 
left. The four low bits can be in the range from 0 to 
IS, and the four high bits can be in the range from 16 
to 240. Without going into the reason just why, the 
high four bits are almost always set to 240, no matter 
what number you may poke into the byte. For 
example you could POKE 53280,129 ■ the byte would 
look like this. 1000 0001, but faster than you can say 
"BLA" the byte will be changed to 1111 0001, which 
means the colour of the border will be white, because 
Ihe computer only uses the low order bits - the right- 
most four bits. After saying all that what this means is 
if you want to PEEK the border or screen colours 
within a decisional IF.. .THEN situation, remember to 
add 240 to the number of the colour you are looking 
for. Phewl 

Actually this is nol good programming! Because we 
only seek a number in the range 0 to 15 we should 
perform what is called a logical AND (the code would 
look like this - PEEKI53280IAND1 5), which isolates 
and reads only the four low bils of the byle. However, 
this is racing ahead of ourselves on our learning curve. 
But we will return to this subject. 

There is a very useful memory location at 197 (see 
Table T, ZERO PACE). This location has been set 
aside by the operating system to use as a storage livic 
for the last keypress a user may have made. In the 
February 1441 edition of CDU an article appeared 
entitled THE 64s KEYBOARD, if you refer to this 
article there is a complete description of this function, 
but, more importantly to us at the moment, there is a 
table within the article which outlines the numerical 
value held in location 197 and its key equivalent (they 
are not the same as screen codes). If you plan to use 
this location within your programs (and I'm sure you 
will eventually), you would be well advised to keep 
the table for handy reference. 

So, how do we use location 1 97? Let us write a small 
program which will test for key input and then execute 
it when it receives the correct key: 



BB.EG#4 

5 REM — A PEEK EXAMPLE *** 



10 PRINT"[CLR]PLEASE USE NO PUNCTUATION" 

20 INPUT"NAME PLEASE";N$ 

30 INPUT"ADDRESS PLEASE";AS 

40 PRINT"[CLR]F1 = NAME" 

50 PRINT"F3 = ADDRE5S" 

60 PRINT"F5 = QUIT" 

70 K= PEEK(197) 

SO IFK = 64 THEN 70 

90 IF K = 4 THEN PRINT N$ 

100 IF K = 5 THEN PRINT A$ 

120 IF K = 6 THEN END 

130 GOTO 70 

When you RUN this program you will be prompted to 
enter first your name and then your address. After 
which by pressing a function key you will either print 
your Name, or Address, or Quit. The thing to note 
about this type of user input statement as opposed 10 
the GET statement we used earlier is that it repeats 
This can prove a useful facility in many cases, but we 
shall be discussing user interface systems in much 
more detail later. The important point was to enable 
us too look at another form of PEEK. 



If you c 



10K = PEEK(197) 
20 PRINT K 
30 GOTO 10 



n the 



If you hold any key down it will keep on repeating, 
jusi make a note of the number and the correspondim; 
key. To stop the program simply press the RUN/STOP 



SPRITES AND SOUNDS 

We all know of the amazing capability of the 
Commodore 64 in it's use of Sprites (also know as 
Movable Object Blocks, MOfisl. and Sounds iwhelher 
special sound effects or music). To enable us to use 
Ihese facilities lo their lull potential we will need to 
constantly POKE and PEEK values lo and from the 
various areas of memory where the Sprite and Smind 
information is stored. We shall be covering these 
< apahilities later in the series. 

BEFORE WE CONCLUDE 



Appendix F, of the U 
characters from the 
quick ob; 



Bed. the 
■, but a 



soon tell you that ma , 
much different to those from the 

_m Display Codes on page 143, The Screen 

Display Codes are Commodore's own, and are very 
useful when you want to POKE characters to the 
screen area - POKEing does have a lot of advantages 
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over PRINTing as we shall soon come to see. 
However, there are olher aspects where PRINTing has 
its own particular advantages. 



fill, i 



? thai 



appear to be empty, truth is they are not, and 
they do have fund Sorts which we will eventually come 
to know. You will also see thai there are many other 
'things' next to the number which do not seem to tie 
characters, for example 1 4 = switch to lower case, 8 = 
disable the shift key and the CBM key. 



TABLE 1. 

A GENERALISED MEMORY MAP OF THE C64. 



can Standard 
is a standard 
v used by the 



The abbreviation ASCII means Ai 
Code tor Information Interchange 
character encoding system which k 
r ; iL',)i majority of computers. 



We can use CHRS to convert an ASCII code into its 

between t) and l r i j ami he enclosed in parenthesis. 

10 PRINT CHR$(65) : REM ASCII FOR A = 65, 
THEREFORE THIS COMMAND WILL PRINT THE 
CHARACTER A 

10 AS = CHR$(1 3) : REM 1 3 = RETURN KEY 
10 PRINT CHR$(147) : REM CLEAR THE SCREEN 



BUFFER 
SCREEN 



2048-40*159 



10 GET AS: IF AS = ""THEN 10 

20 IF AS = CHR$(160) THEN PRINT" SPACE BAR WAS 
PRESSED" 

30 IF AS = CHR$(133) THEN PRINT" KEY F1 WAS 
PRESSED" 

40 IF AS = "L" THEN PRINT CHR$(14): REM IF 'L' 
PRESSED SWITCH TO LOWER CASE 
30 IF AS = "U" THEN PRINT CHRS(142): REM IF 'U' 
PRESSED SWITCH TO UPPER CASE 

60 IF AS = CHR$(134| THEN PRINT CHRS(1 47):REM 
KEY F3 CLEARS SCREEN 
70 GOTO 10 

We shall be dealing with these codes in much more 
detail a little later on in the series when we start to 
construct more substantial programs. 



BASIC INTERPRETER 



NEXT MONTH 

Neil issue we shall be exploring the world of random 
numbers and how we can generate them, and use 
(hem in simulations and event timing environments. 
Wc shall also return iu strings and have a look at just 
how easily we can cut them up, and manipulate the 
pieces. Further to this we shall construct a real lime 
digital clock just for fun. 

So until next month, happy finger tapping.... 
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RASTER MASTER 



Yet another Raster utility hits the streets. (Doesn't anyone program anything else these days ?) 
DAVID BRYSON 



Many utilities now are usually repeals of tt if same utility 
some Mine ago. hut butter (or perish the thought, worse!) 
This is why I decided In re-invenl the wheel, and its 
name is "RASTER MASTER" With this utility, you can 
make up colour data for raster bars, and presentation of 
your own demos and names would he both easier and 
better. RASTER MA5TER works by changing the colour 
on every raster lirii' of the screen . Before starting, if vou 
have not come across the term "RASTER", it is a VERY 
fast beam thai draws the picture fn a television, and 
travels across the screen, starting from the lop and 
finishing at ihe bottom. 



GETTING STARTED 



When you first load RASTER MASTER and press a key 
you are presented with a virtually blank screen - but 
don't despair! Pressing "E7" will take you into the help 
screen, and you can immediately absorb information 
(here it you don'l like reading instructions. The reason 
why the screen is virtually blank is because no colour 
dala is in memory, therefore to see example colour bars, 
press "L" on the HELP SCREEN to load a file. Type in ihe 
filename "DEMO.COL" and it will load the file from 
disk. There is also more example files called 
"DEM02.COL" and "DEMO:i.COL" which you can load 
in a similar manner. If you do nol wish to load or save- a 
file, press any other key 10 exit, although il is advisable 
that you press T7" again, as pressing another key mighi 
activate a function accidentally. 



USING THE EDITOR 

When you have clone this, the screen should display lots 
of pretty colour bars. You can edit the colours by 
moving up and down with the cursor keys anci pressing 
"A" and "S" to move through ihe colours of the line thai 
the cursor is on. If you want an even prettier effect, try 
pressing RETURN a few times. This should scroll the 
colours up, down or nol at all, depending on how many 
times you pressed it. If you have one ol I hose tellies thai 
display Ihe whole screen range, you may notice a slight 
ghlch at the left-hand edge. Vou can disable the borders 
if you don't like il or think it looks boiler by pressing ihe 

-B- key. 

BLOCK COMMANDS 

One of ihe powerful i. nmmands in the edilor is ihe bl n k 



commands. To memorise a block, press "I" al the start 
of ihe blor k and "2" al ihe end. Vou do not see anything 
i-...ipp-- vvh, n do'iv,-; Mils and nov oiislv. miisl 
press "2" further down than "1". Once you have 
grabbed a block, you can duplicate il al anolher position 
by pressing "i", or if you want a mirror-image of the 
biock press BACK ARROW. This is very lime-saving when 
making colour bars that arc- symmetrical. 

THE COLOUR TABLE 

I he colour table is a streU h ol memory w hich holds all 
the colours for each raster line. Il is in the usual format, 
i.e. one byte per colour, and can be 192 bytes maximum 
(which means 192 raster lines, which is the most you 
can display on the editor screern The program actually 

inserting colours off the screen, and deleting them back 
i in ana:.'-. The lunin table i an be saved on I when on 
the help screen and then be loaded into a demo or a 
game to be used - in fact, you could use it with Andy 
Partridges famous raster bars routine, fealured in an 
earlier issue of CE)U. hut more about this later. The end 
of the colour table is signified by a thin while line, whir h 
you can move about with the keys *P" and "L". When 
you load a colour table, there is no need to set Ihis. as 
the program does il automatically. This is why, when 
saying a i olour table, you should always set the white 
line to the correct place. 

USING IT IN YOUR OWN 
PROGRAMS 

On the disk is a small example program 
("KA5TERBAR5.BASJ which shows how you can display- 
raster bars in your own programs, even if you don'l use 
machine code. First, you have to load ihe machine code 
file which displays the colour bars, called 
■liASTFRBARS.MC" and also the colour data which you 
saved previously (you did save it, didn't youO Remember 
there rs absolutely no need to use my display roulrnc-, as 
the colour data is in standard form, therefore it is 
possible lo use your own it you have knowledge ol 
machine code. In your program rail Ibis routine at the 
star! using "SYS S2224" but before it is ready to run, you 

displayed. The^lenglh of the <<,luur dala i- important 
(which is displayed IN HEXADECIMAL on the help 
screen of the RASTER MASTER editor) as well as whal 
verlir a I line you want your t olour liars to start. Vou can 
choose any line ranging from $32 (50 decimal, top of 
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ON THE DISK- 



stage the progra 



vilh a simple 64-TEL logo. At thl 
mpis you to enter the present lime 
rirsi enter trie nours followed by the minutes the 
seconds. The inputs must be two digits. (Eg: 8 o'cloc 
would he 08). Enter the current date in the s. 
When you have finished there will be st 
accessing as the index page is listed. You are 
'Teletext' service. Pages from 100-199 can be e 
I'll- user. I'll.' \>.r:,'; i\ I lii- loaded I 

Note that the irulc\ page resides in memory i< 
access, rh is page appears if page 100 or an ui 
page is required. All pages available on tht 
found by pressing 'P'. That is baskally how t 
pronram. Some other nperal ii >nal keys are given 



Fl Is go into Editor mode. 
F7 is leave 64-Tel. IDo not us< 
SPACEBAR Reveal stop, tfs 
characfers. Useful for arts WW 
have also activated the extei 
II allow you tc 



FLASHING CHARACTERS 



UN STOP/RESTORE), 
e is to show up h 

0 jokes and questic 

1 voice of the SID 
an ex&rtial sound 



THE EDITOR 

Cre.ilinj; your nun. or edMing esisling pages is a vei 
process. When you use F1 to enter the Editor from £ 

i ursor will .ip|ie.)r in the lup lelr hand oi tin- -.creen. You can 
now Edit the screen in anyway you wish. The available 

ii III i ml; .ire, i is -10' J 1 ( hi racier-. (The trip screen line is used 
by 64-TEL and the bottom screen line displays function 
messages I. All ihe i nnlrnl -tup- aie available. Therclorc vnu 
can use The cursor keys to position the cursor. The SHIFT 
plus CLEAR/HOME keys to clear the screen, maybe CTRL 

!■-■■: I ; i ■ ■ i ■ :■. - 1 ■ ■ .■ I <. I '. mv: n i ■ i :i. 'iv- ..c. 

also available. 




REVEA 



F1 - Return to 64-TEL. 

FJ - Sels page iHji kground: 1 colour. Continuous pressing oi 

F2 will scroll through all 1 6 colours. 

F.i - Toggle UPPER/LOWER case. Use F3 instead of 

CBiWSI II T X lo properlv noisier llie type case of Ihe page. 

F4 - Remove a page from disk. The page rcriioved is the one 

currently spc-ciiicil by Ihe pane number. Use F7 before using 

F4. 

F5 - Toggle FLASH/REVEAL mode. Flash mode is indicated 
by Ihe cursor flashing. Entering the Editor from 64-TEL 
aulomalii .illy sels il to reveal mode. 

F6 - Save a page to disk. The saved page is Libelled with tin 

current page number. Use F7 beforehand. 

F7 - Enlerthe new page numbec A '1 ' will appear in the lop 

left of the si reen. jusl enler two more digits. 

FB - Copy 5CREEN to RAM. (More on this laterl. 

CBM - This is the Editors reveal key. The spacehai is already 
being used lor tdihnj: purposes. CBM will lei vou see how 
your reveal CLR-UP is working. 

When you have limdicd designing vour page and are ready 
to save it lo disk, press FH. iThis is essenii.il otherwise the 
pane you Liter on load back from disk may look quile 
r li tier er ill. Next, pres- f h lo save your page. Lontinue editing 
or creating new pages, or return to 64-TEL through Fl, 



Reveal mode w 

that the characters are hidden and do not appear l 
you press CBM in the Editor, or SPACE in 64-TEL. Fol 
the same procedure as above for the FLASH charact 
but remember to have the Editor in REVEAL mode. 



A FRESH START 



1. Insert a new- fur matted ili-k into ihe drive. 

2. Use the Editor lo remove all existing pages. Then from 
Basic use rhe command OPEN1 5,8, 1 S,"S0:8 ":CL05E1 5 
lo scratch the PBAM tile. (The PBAM file is a page block 
availability map, like the 1541's BAM, which ihe 'P' 
operation in 64-TEL uses the available pages). 

When 64-TEL is then RE-RUN, a disk error will occur as 
ihe program pies to load Ihe inde> page. Ignore this and 
start creating your pages. It is a good idea lo write your 
index nac.e first. I his can always be Edited later, but its 
initial present e i- lo slop disk error occurring next time 
64-TEL is used. If you forget which pages you have 
created, use the key 'P' operation in 64-TEL. 
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HOW IT WORKS 

An assembler listing, M/C 64-TEL, is provided i 
disk. The 1 prop ruin is lull nun hine code and is intei 
with an IRQ interrupt routine. (Which handles the clock 
display update and ihe dual bac kground uiltiur screen). 
The program consists of two main parts, 64-TEL and the 
EDITOR. 64-TEL handles PAGE and PBAM disk loading 
whilst the EDITOR deals with the page saving. The 64's 
memory is used in the fallowing way. 



$AOG0-$FFFF ■ 
S9000-S9AOO 
S1900-S8FFF 
S1R00-S10FF 
S140O-JI7FF 
S1000-S13FF 
SOCO0-S09FF 
S0600-50BFF 
$04t)0-$07FF 
S00n0-$03FF 



Kernal ROM, I/O, Bas 
64-TEL program. 
RAM. 

PBAM (Used aresSlfl 
Index page colour. 
Index page text. 
Current page colour. 
Current page te 



Operating syster 



iisplay. 



i SUHin.l-SltHH). The e 



PAGE BLOCK AVAILABILITY MAP 

The PBAM works in the following way, X = Pagt 
(100-199). 

A = PEEKIS1 800+XI. If A = n then page not availab 



.^iTFH/^i.iBFH - S( reen background (. 
Sli^r'i/SiW'l - Flash/Reveal mode. 
SirE.VfilBEA - Upper/Lower case rr 
S07EB/SOBEB - Page next. 
SOBEB-SOBEB have the same content 

Locations $07EH and $()7E4 are U 



routine. If a viewed page has a non-black background 
colour, you will notice 2 RASTER screen splits. One 
below the top screen line, the other above (he bottom 
screen line- Between these I RASTER splits a different 
colour background can be used instead of the black line 
lh,it appears on the fop and bottom screen lines, 
r LAS 1 1 REVEAL mode works by altering VICMEM address 
$D0I8. This stales where the screen display will start. 
The IRQ routine will set SD01H lo display the screen at 
S0400 or S0B0O. The IRQ routine operating from a 
RASTER IRQ runs al 100Hz. The keyboard scan routine 
in ROM is called on every other IRQ call. Therefore it 
runs at normal pace. The operating systems normal 
interrupt mechanism at address SDCOD was disabled to 
avoid anv possible screen flicker. 

64-TEL is situated just below Basic ROM. Area SCOOO- 
SCFFF is used too frequently, and besides, putting 64-TEL in 
this area would have made it im i impartible with the 



Now you can use 64-TH in ( onjunt linn with any Basic 
program that you may be developing or running. For 
example, instead of thumbing through your manual just run 
64-TEL (SYS.S6864) and load up thai help page from disk- 
When you have finished, exit from 64-TEL and continue 
with whatever you was doing previously, ^iiur Basic code 
can use up to about JOK before it starts to corrupt 64-TEL. 
While in Basic you can see that 64-TEL is still active 
through the oinlinuouslv updated clock, you can remove 
this by hitting RUN/STOP and RESTORE. 

FINALLY 

I have included a simple demo program lo illuslrale bow 
64-TEL can be used with a Basic program. If you have 
lollownl the commands aliove (POKE44 etc), then load the 
ilen in program and run it. Your own programs should not 
alter the IRQ vector al S1V1.14-S0S1 5 or your program will 
hang up. WARNING, 64-TEL handles no disk errors. 
I he re lore ii is not failsafe. However, if all (he guide lines 
are lol lowed proper l\ I hen everything -hould be Okay. 
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Our tutorial into Machine Code programming continues, by J Simpson. 



son-- desie.ned lor ihe begini 



world of machine i uili- programming on The commodt 
64." Thai's what (he man said, and lhal's exactly what th 
series of tutorials hopes to bring you. 



the LINES 80 to 100 are the ihree memory locations si 



PART TWO - EIGHT-BIT ADDITION 



istructed (albeit rathei 
outine- We shall no' 
in addition ruuline. 



ADDITION LDA VALUE1 



which would place the values required into these tv 
bytes ready for compulation [we shall look a 
closely when we Stan discussing subroutines}. 



EIGHT-BIT SUBTRACTION 



VALUE] 
VALUE2 
SUM 
END 



SUBTRACT LDA VALUE! 



LI.NiC 



basis from within a program Ihen this 



mitted. 

LINE 30 sta 
and the first 
to load the Ac v 
labelled VALUE1 
label. ADDITION, which would be called d 
calling subroutines later in the series). 



.'.ilue hi.' If I 



Libel t.illed, ADDITION 
LDA tells the processor 



NE 40 clears 
Idition overfk 
eater than 255. 



the 



rry (flagl ready to be ft 



LINE 50 adds the value of Ihe memory byte, V.ALUE2, plus 
Ihe value of the carry bit (in this case 0, because we 
cleared it earlier), lo the contents of the Ac (which held the 
value iH VALUED. 



LINE 70 ends the rc 



VALUE 1 
VALUE2 
SUM 
END 



between the two roul 
The differences, apart 
data bytes, is confined to Lines 



s not a grefll deal of difference 
ADDITION and SUBTRACT, 
he values held in the variable 
and 50. 



LINE 40 this instruction is the opposite of CLC, in that SEC 
means SEl Ihe Carry. In other words the carry bit (flag) is 



LINE 50 instead ui ridding with carry we now SuBlract 
with Carry. This allows to subtract from Ihe Ac Ihe data al 
the specified address without a borrow. 

In our example we first loaded I fit: Ac wilh Ihe contents of 
VAI LIE I (50). We then sublr.it ted Ihe contents of VALUE2 
(40) from the Ac. And stored the result in SUM (10). 
During the subtraction process we used the carry flag lo 
test far an underflow, if the result ui ihe subtraction had 
been less than zero, then the carry flag would have 
become clear. 
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PROGRAM 



Understanding (he full implications of using the Carry will 
become more clear when we look at Id bil addition and 
subtraction. 



SIXTEEN-BIT ADDITION 

An eight-bit addition will only allow the adc 
numbers within the hinge ol 0 Id 255. For more 
operations it is necessary to use 'multi-precision 
add numbers which use sixteen bits or more, 
demonstrate addition on 16-bits, but they can re 
extended to 24, 32 or more bits. We always use t 
ot cighl-hils or a byte. Check this example: 



AUDITION 



VAL2 
SUM 
END 



LDA VAL1 
CLC 

ADC VAL2 
STA SUM 
LDA VAL1 + 1 
ADC VAL2+1 
STASUM+1 
RTS 

BVT 255,160 
BYT 237,46 
BYT 0,0 
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First ol" till let us examine the numbers we are adding 
logelher. The first p.iir ol numbers held in the two bytes ol 
VALI and VAL1 + 1 represent 41 215 ISAOFF). The second 
pair of numbers held in VAL2 and VAL2 + 1 represent 
12013 IS2EEDI. We store the low eight-bits of the 16-bit 
number in the first byte, followed by the high eight-bit'- in 
the second byte. 

"tun probabk know ilut il is sl.nul.ird to store a large value 
in the Low/high byte formula but if you are unsure just 
how I came to arrive al 255 No!. IMMhi) VALI, and 237 
llo), 46 (hit VAL2 I will explain. To calculate the high and 
low bytes of a I 6-bil number, th.il is a number in the range 
of 0 to 65536, we must first find the hi-byle. This is simply 
done by dividing the 1 6-bil number by 256. and ignoring 
any fractional parts, to obtain the lu-bylc we then subtract 
the hi-byte from the original number and multiply lire 
result by 256. A simple line of BASIC code will do this tor 
us, namely: 

10 NU = <NUMBER TO SPLIT>:HI = INT(NU/256):LO = 



J-INT(HI)"256 



mbler 



vill hav 



It we now look at the 1 f>-lnl addition program you will sec 
that lines 10 to 40 are just the same as in the H-bil addition 
program, however when we add the two Hi-bytes ol 
VAL1+1 and VAL2+1, we did not precede the addition 
With a CLC instruction (we only use CLC at the beginning 
of an addition). This means we add together the two Hi- 
byte values plus the value of the carry. In the case of our 
addition this is what took place: 

When VAL2 was added it took the value held in the Ac 
(taken from VALI) which took it beyond the range of a 
hyte, 255. This resulted in the carry bil being set 11). Now 
the carry will represent 256 to be added to the Hi-byte, or 
adding 1 to bit 0 in the Hi-byte (which has the column 
value of 256). The balance, 236, which was left in the Ac 
is then stored in SUM1 at line 40. Then lines 50 to 70 
added together the values held in VAL1+1, VAL2+1, plus 
the carry. We know ihe carry bil was set. so we carry over 
256 to be added to the result of VAL1 + 1 and VAL2+1 . 
Here is a graphic example of what took place: 

(LOW BYTE) 



VAL1 + 1 =160 
+VAL2+1 = 46 
♦CARRY = 1 



%1110 1100 CARRY = 1 
'REPRESENTING 256) 
- CARRY 256 



%1010 0000 
%0010 1110 

%u000 0t>m (The first c< 
represents 256) 



SIXTEEN-BIT SUBTRACTION 



10 



e form of number 

lommand and if you convert the decimal 30 

number into its hex equivalent then il is simple to split the 40 

number into Hi/Lo bytes (e.g. SA0FF = JA0 and SFF. 50 

S2EED = S2E and JED), this would then be incorporated 60 

into your code- using a suitable pseudo-op. 70 



90 VAL1 BYT SFF,$A0 

or if your assembler uses the pseudo-op, h 

100VAL2 HEX ED21 



90 



LDA VALI 
SEC 

SBC VAL2 
STA SUM 
LDA VALI + 1 
SBC VAL2+1 
STASUM+1 
RTS. 

BYT JFF.J AO 
BYT SED.S2E 
BYT $00,$00 
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Suliir.n In hi i>, lilt- reverse nl addition. We SEI Ihe Carry io 
one at the start Ot Ihe operation, and ii ihe result of the In- 
byte Ik'( (lines a niinn- runnbci (hen I he carry is t leared 
arid thus [he la-byte would have borrowed from the hi- 
byte (Ihf value of 2551. The result would be correct when 
Ihe hi-bvte is calculated because we have borrowed the 
least signilit.ini bit (the righ1-mn-,t bill from the hi-bvle 
during the calculation. If the result of ihe lo-byte 
subtraction Hid not underflow, then the carry would 
remain set which would i rid it ale a "iin Imrrnw" 1 1 mdition. 
Study Ibe two programs, addilinn ,1111! subtraction until you 
are l.imiliar with them. Try using different values, and 
stepping through each line of code with a paper and 
pencil noting how the changes occur (tracing, or single 
■lL-|jping. 1 >n paper 1- explained mi in- lullv inwards ihe end 
of this morilhs article). 



MULTIPLICATION 
(GETTING TRICKIER) 



1,0 Muinm 

70 LSR MPK ; SHIFT MULTIPLIER KIGHT 

80 BCCNOADD ; TEST CARRY, IF CLEAR NO 

ADDITION SO BRANCH 
90 LDA RES ; LOAD Ac WITH LO-BYTE OF 
RESULT 

1 00 CLC ; PREPARATION TO ADD 

lit) ADCMPD ; ADD MULTIPLICAND TO 
RESULT 

1 20 STA RES ; NOW SAVE LO-BYTE OF RESULT 
130 LDA RES+1; ADD REST OF SHIFTED 
MULTIPLICAND (HI- BYTE) 
ADC TMP ; ADD TEMPORARY DATA 



BYTE 

150 STARES+I ;SAVE 
160 NOADD 
1 70 ASL MPD 



ll-BYTE OF RESULT 



LEFT SHUT MULTIPLICAND 
ROL TMP ; LEFT SHIFT AND SAVE BIT 
DEX ; DECREMENT THE COUNTER 

BNE MULTIPLY ; IF NOT FINISHED DO IT 
AGAIN 

RTS 



It is nol necessary for me to explain how we multiply two 
numbers in decimal nolation, we all learned this at school. 
The melhotl for mullipK ing iwo binary numbers is exactly 
the same. Let us multiply 5 x 3: 



101 Partial Prod uc 



The multipln ation is performed by multiplving the righl-uvi 1st 
digit of the Multiplicand b\ the Multiplier, ihen one multiplies 
ihe nexl digit and so on. We oliset the digits lo ihe lefl by one 
position. Or, equivalently we could say thai the partial 
product hail Ijeen 'shifted' one position to the righl before 

In order lo perform multiplication ihe computer will operate 

the same as we did above. II will 'shift' each line one plate to 

(he right then add logethei all of the lines. However, because 

we are dealing with .1 full bvte. eight bits, then the computer 

must shift all eight lines, or eight 'shifts'. 

Here is a routine to multiply two eight bit numbers (8x8 

multiply). 

10INIT LDA* 



STA TMP 
ADDRESS 
STA RES 



VVI : I T 1 - : -.1 ; I HVn S 



270 END 

Because we are doing eight-bit multiplii ation we will have 
to test each bit oi the multiplier IMPR), but unfortunately 
there is no instruction with which we tan sequentially test 
the bits, Il is only the bits (flaiM in (be status legisler iSK! 
which can conveniently be lested. This is a limilalion of 
most microprocessors, and as a resell ol this limilalion il 
will be necessary to shift the byte and test Ihe bit. What 
actually occurs when shifting is that every bit in the byte 
will move right or lefl l.iv one position. The bit which is 
shifted out oi" the byte, or 'falls' of the end, is placed into 
the carry bit of the SR. Fig 1 demonstrates Ihe 'shirt' (you 
will note thai Ihe ligure demonstrate"- Ihe lefl shift, or ASL, 
to study a right shift, or LSR, then simply reverse the 
dnei linn of ihe arrows). Theie are ditieient | >< i—ibi In u- 
depending on the shifted 'bit' but more of this will be 
discussed later. 

However, since we need to test each oi the eight bits of ihe 
Multiplier, and since we ran easily test the carry bit, then 
we must shift ihe Multiplier by one |msition eight separate 
shin 

jv j^jw f^. ^-jv ,-|* ■*[ — 0 

3 



I will 'fall' into the carry bit (flag) 
each time in order to take the 
it ihe Partial Product (PP) which is 



STA RES+1 ; AND (HI) 

LDX #8 ; WE ARE USING THE X INDEX 

REGISTER AS A COUNTER 



p 



ROGRAMMING 



= 65025). Unfortunately the 6510 has few internal 
registers which means that the Partial product, the 
Multiplier ,inil [he Multiple ,inil i annot In- stored within 
the 6311) itself. Therefore iw inusl set aside some RAM 
memory locations, or eMem.il legislors, within which to 
store them (Partial product into KFS and KES+1, Multiplier 
into MPR, and Multiplicand into MPD). Wo will shift ihe 
Multipln ,inrl ci! ,i nrl intu ,111 .ldilress l.iln-lled l.MI 1 prior ti> 
adding it to the Partial ptoduct (RES, RES+1). 
We shall now examine this routine in more detail. There 
are several important points lo discuss, as well as the 
instructions whit h we have nut i uvered before. It is very 
important, when developing good software, be it games, 
i.itililies (ir even demo-, to hive a thorough understanding 
of the multiplication issue. 



DETAILED EXAMINATION 

Lines 10 to 40 are quite simple, we have dealt with load 
and store instructions, and so they iJti not require further 
explanation, save lo say 'hat it ill;- is an often railed 
routine from within a larger program, then it is good 
I mi;'/, miming practit e in zen ' I lie tempi iraiy data livle and 
the two-byte result before execution. 

Line?!) LDX #8. This is our first use of the X index 

merelv as a loop counter. So, by usinn the n svmlnil. the 
same as the LDA instruction, we have instructed the CPU 
thai the value following it is Ihe literal value of 8 which we 
■Hue within the \ register and not the contents of memory 
location 8. We are using the counter in ordet to stop 
shifting Ihe MPR at the right lime. We need eight shifts, 
one for each hit, so each time a shift <n i ur> we (let rerun it 
the X index register. As soon as the value of the X register 
readies /em the mult i phut ion lias linished. 

Line 70 L5R MPR. This instruction means 'Logical Shift 
Right 1 the ( (intents of Ihe byte MPR. We must test the least 
signiii( ant bit (that is the righl-most bit) of Ihe MPR, and, 
as I ini!i( ated earlier, this i annot be done with a single 
instrui tii in. So first we must \hi1f it. ihen we must ten! the 
( arrv I ill In r'inri out if the I jit sh ;ted out was aim ad, and 
use this to either branch or not. If ihe hit was a 0 ihen this 
indicates a 'no addition' situation. 

Line 80 BCC NOADD. Test the the value of the carry flag, 
BCC NOADD means Branch if Carry (hit) is Clear' to the 
address labelled NOADD. If the carry is clear, then this 
tells us that the bit shifted oul of the byte was a zero and so 
it does nol require ti> be added. 

This is our first cut ounter with a branch instruction. So far 
the routines we have dealt with have all bee 1, sequential. 
In other words each instruction being executed after the 
previous one. * tllviuusk- we need In perlnrm lugii al tests, 
sui h as testing Ihe i ai ry bit, whit li will direct us to anothei 
part of the program, similar lo the IF.. .THEN of Basic. 
Branch instructions penorm such functions. In our branch 
instruction BCC the CPU will branch lo a new address if 
the carry bit = 0, in other words the next instruction at 
address NOADD (i.e. line 170 - ASL MPD). If the test fails, 



in other words the carry was set (=11 then no branch 
would ore in thus program execution would continue wilh 
the next instruction after BCC NOADD. 

Llne90to150 The lest failed and the carry bit is set. We 
must add the MPD to the Partial product (here the RE5 
registers). 1 he MPD is held in TMP and MPD. The 16 bits 
of the Partial product are held in RES and RES+1. We 
simply add Ir^elher the two 16-bit numbers as we did in 
the 16-bit addition of the earlier program (Sixteen-bit 
Addition). 

LDA RES - the Ac is loaded with the lo-byte of RES. 
CLC - prior to any addition the i arrv hit must be cleared 
ADC MPD - add the MPD to the Ac which already 
c ontains RES lo-byte 

STA RE5 - store the result of the low pan of the addition in 
RES lo-hyle (the carry will he either set or clear depending 
upon the result of the addition, and any carry whir!; may 
have been generated will cairv over to die hi-ordei pari > 
the result). 

LDA RES+1 
ADC TMP 
STA RES+1 

These three instructions complete our 16-bit addition. We 
have now added the MPD lo RES, however we mus| still 
shin it by one position lo Ihe left in anticipation of the next 

add. - 

Line 170 ASL MPD - 'Arithmetic Shift Left' will shift the 
c (intents ol the rtgi-ler ,\\[T) one fiositiun t" the left, the low 
part of the Multiplic and. However we cannot lose the bit 
whir h falls on the left end of the byte. It 'drops' into the 
carry but we cannot leave il Ihere because it would quit kk 
he destroyed when we penorm our addition. It must, 
llierelorc lie placed inlo ,i semi permanent location. We 
use TMP for this. 

Line 1 80 ROL TMP - 'ROlate Left' the contents of TMP. This 
isdnicrent lo SHIH in that it pertbrms the same function but 
■a ill i ihe additional leatuie that Ihe bit in Ihe ( arrv is Ion ed 
into Ihe right most liii po.iiion ant I ihe hit whic h 'tails' of! 
the end is placed into the carry (see Fig 2. Rotates. The 
ligure demon si rales ihe left rotate, ROL, lo demonstrate a 
right rotate, or ROR, simply reverse the direction of the 
arrows). So Ihe hit whit h lei I oft Ihe left-most em I pi min hi. 
during execution ol the previous instruction ASL MPD (line 
170I, and held in the earn,, will now he Ion ed into t):-c right- 
most position ot Ihe register TMP. 

I his finishes with the arithmetic operations of the: routine 
but we must slill tesl whether the operation has been 
performed a full eight times. 



carry 

I Q 1 
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LllM 200 BNE MULTIPLY - 'Branch if the result [in (his 
case, ill the X [let renienl) is Nt.it tqual lo zero' lo memory 
address MULTIPLY (Line faO). This is another test-and- 
llianch instruction. While the X mdey register decremenis 
to a non-zero value the CPU will automatically branch 
back lo (he the memory adrlre-s lolluwinj; the branch 
instruction, in this program. MULTIPLY. If X has 
(lei remenlod lo 7ero then tin. 1 result ,,i I In-' lesl will hi 1 I.iIhv 
and so the CPU will execute the next sequential 



use the space-bar to 'step' through each line of [he 
program. All of the registers are displayed in liin.irv digils 
which will give you a much c leatet pn lure of exactly wh.il 
is taking place, especially during ihe 'shift' and 'rotate' 



is the Z flag (See Status Regist 



.■■ill I 



it Ihe b 



■ijHi i 



•, just the 'bare Irones' but it 



f ML. After you have used the trace, 
maybe .liter several times, you will fully understand the 

mi ( h.iiiKiti d\ v. In. h iFisiuu i- manipulate ihe contents 

hi memory, of ihe CPUs registers 'Ac' and 'X', and just 
how the tarry bit (flag) 'C, is being used. 



paper and v 

by hand 
DIAGRAM 



y that 



Lines 230 to 260 are the m 
f'\lrrn.il registers used in tins routine 



y locations for ihe v. 



THE TRACE PROGRAM 

It is very importing if you wish In program eificienily in 
ML, that you lully understand such a typical program as 
the 16-bit multiply routine in complete detail. I have 
introduced you lo many nev, insltuc lions, and the routine 
is much longer than any previous. I strongly suggested, 
before you ( onlinue. thai you load the program i ailed 
TRACT, which can lie found on 1 h is months disk. Il is a 
BASK program elm h simulates tile ML louline and will 
step, or trace, through each instruction of Ihe multiply 
routine displaying each of the registers used and updating 
them during each iteration. II is simple lo use, just input, 
when requested, the multiplicand and the multiplier, then 



would indicate this. II 
eight zeros would be 
would place Ihe relev 
MPD. The C-bit and 
e undetermined. 



mi. a. 



Ihe TMP, RES, and RES+1 registers 
these would also contain dashes. 
The next inslrurtion STA TMP will change the dashes in 
TMP to zeros, and so on willi cai h instrut linn. I've started 
the firsl of ihe eighi iteraiions ror vou but il is up lo you to 
finish IL 

Using the hand trace method in conjunction with the 
BASK" ts'ji'o program will allow vou to verily ihal which 
you do by hand. All of this will, essentially, leach you very 

good i in ijjr.ii inn pi'ii' !i< '■' and lei hn que and will ensure 

lh,it when von starl wrwng your own programs you will 
create more fluent programs .with ley\ei 'hugs' or logic 



BACK TO MULTIPLYING 
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ilised lolhevalueofB. 



the program ru 
important. 
Eftec r ive prograi 



ing shifts lor the n 



'trick' which we can use in mulliply algorithms is thai 
every time the multiplier is shitted to Ihe righi ihen a hit 
position on the left is (reed up. We can also see lli.it the 
first result will take up, at the most, nine bits and that after 
shifl the resull will be increased by one bit again. 



the ni 

What this boi 
memory location for the 
I hen use the bit positions which 
multiplier as it is shifted. Now 
MPR (multiplier) right which wil 



thai 



We will e 



If the 



n that has become free. We will use the X register 
as our counter for the number of bus bein» shiited 
Unforlunalely ihe CPU only has one internal reglMet 
which can be shifted, and that is the Accumulator 
Becauw we are going to shift both the result and the 
mullipliei we need lo determine which one we should jip 
into ihe Ac. Well, since the resull must lie added lo ihe 
MI'H every lime a set bit is shifted out. and sin< e the CPU 
also ddrls something only lo ihe Ac, (hen the tesuli is besl 
served using the Ac. The other numbers wilt reside in 
memory locations. 

Ac (result high-byte) and RES (resull low-byte), MPR and 
MPD will be as before. So, then, here is our alternative It 
x B bit multiplier 



Line 50 BCC NOADD the result of the shift has two 
poss,h.ln,es. either the carry is set or clear- If clear, then 
no addition is required so branch, otherwise continue w-'ith 
the next instruction which is lo perform Ihe addition. 



We miisl always clear the carry before addition (and we 
know if must have been set simply to have reached this 
stJge 01 the program!. So we add ihe multiplicand lo the 
accumulator (Ihe Ac holds ihe high-byte of the result). 



this is the Parlial Product held in Ac and RES. By shifting 
'"'t.ni.H..' Ihe Ac right one bit, the left-most bit will 'drop 
on inn. ihe carry. The carry bit is then rotated into the 
KLS iresiill low: register which hold, ihe low-byte ol ihe 

result. ' 



120 RTS return from subroutine to call 
1 30 to 1 50 are the memory registers w 



simine this modified loutine you will see that i 
rund half Ihe number of instructions, and, as i 
this, and the selection of the correct registers, i 



ADC MPD 
NOADD ROR A 
ROR RES 



MPR 
MPD 
END 



BYTO 
BYT 5 
BYT 3 



IN CONCLUSION 

Well, we have covered a lot of tricky ground this monlh, 
but never-the-iess it is ground rh.H needed to l>e c overed 
Examine the addition and subtraction programs, and 
create your own. See just how you might improve on 
things. I recommend that you use the trace program until 
you fully understand the first fl x 8 bit multiply program. 
Ihen move on lo the second program and compare Ihe 
two. Note the changes and just how ihey can improve 
eriiciency. You can create your own trace program on 
paper, as I outlined earlier, ibis will dearly show you how 
things lite the refers ami Ihe shifts work. 
Until Next Month 
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ON THE DISK 



"1 



WORDSEARCH 



Create your very own customised WORDSEARCH puzzles with ease . by STEVEN BURGESS 



d about those wordsearch puzzles? Wouldn't 
5s to baffle your friends and colleagues (and. 



self.) 



I the 



Well, my deat friend, read on and all your dreams will 
e realised. All your hopes fulfiled and all your friends 
rid colleagues will hale your guts. 

When the program has loaded via the C.D.U. menu, 
au will be presented with another menu. The options 
re as follows: 



CREATE WORDSEARCH 



Prints the Wordsearch grid DM to the printer. The grid h 
30x30 and uses thirty printer lines. Between each lette 
across there is one space. 



LOAD WORD LIST 

Allows you to load a previously created wo 
END 

This simply returns you to the C64 startup sc 
pressed it by mistake then switch on the drivi 
C.D.U disk and type: SYS 21 52 




HOW IT 
WORKS 



which way the word 



will ri 



iml lli<. i 



choose how mjriy words you want lo enter bul I 
woulrjn'l go loo high. Once you have typed in a word 
there is no going back, except to start afresh, so make 
sure you type very carefully indeed. 



ight cliffon 
Then it will decide 

coordinates in the grid 
where the will start. It 
checks first if the 
word will fit and, if it 
will, if there are any 
athet kaea in its path. If there aren't then it places the 
word, l( there are, and the word can still he placed 
through the other word then 



ihw 



e then 



another direction, another 
This data can be seen flashing up 
u select CREATE WORDSEAis'CH. 



SAVE WORD LIST 

Allows you to save your word list to diskette. Asks for 
filename and then saves .is ,i sequential file. 



PRINT OUT WORDSEARCH 



FOOTNOTE: This program was.wrirten with the aid of 
LASER BASIC, from ihe OCEAN IQ range of utilities. It 
was compiled with LASER COMPILER. 

For owners of LASER BASIC, there is, on the disk, a 
copjy of the source program which you can mess about 
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When I closed last month I told you thai I would bring 
you news of .1 program lh.it gave FLI I DISK JACKS- 1 it's 
compatibility with the STAR LC1C1C. Well, here it Is. A 
Couple of people, namely MR CLIFF KENDALL OF 
( I'MhiKIA ,ind MK DENIS REDINGTON OF ESSEX, wry 
kindly sen! me copies of the program that they had 
modnied tor use with the above printer. I had to choose 
tine and, because they were both of a high quality, I had 
to go on a first come first served sort or" ba-is which meant 
that MR. KENDALL was the lucky man. On the disk this 
month you will find his program, filed as "STAR FD|". I 
hope lhat everyone will appreciate his work. This month I 
have selected ten letters from the mailbag for you to 
peruse at your leisure, three of which Lire from outside the 
UK which makes me very happy. To everyone that has 
sent lellers and [u-.n l yel reieived ,1 lormai reply please 
bear with me. Due to the volume 01 letters that we receive 
at the TfcCHNO INFO HQ it just isn't possible to answer 
them all personally. The great majority of you will receive 
replies as soon as it is possible and a few of you will be 
privileged enough to receive a telephone call from yours 
truly if you supply your number!! Anyway, if you don't 
receive a reply straighl away, please do not send me 
copies of your letter asking what has happened. This only 
confuses both niysell and my filing system! From this day 
on I am guaranleeing thai everyone will have a reply 
either by post or in the magazine eventually, and as 
always, any disks sent to me will be relumed. Please have 
p.itiem e. Well, now that that is over, let's gel on with this 
month's selection of letters I hope that you find them to 
be both interesting and useful. 



THANKS FOR CDU 

DearCDU, 

I doubt that I will be the first this year to praise your 
magazine for its content, but I feel that I should make my 
feelings known. I have only recently found out about 
CDU and was, to say the least, pleased that someone had 
the sense to bring out a magazine for those who realise 
thai computers are for more than just vegetating their 
brain on games. Especially do I find "Techno-lnfo 11 
interesting as it helps everyone to get mote from their 
machine - even us lowly ones that know very lillle 
machine code. However, if I was lo be critical. I nodd 
say that it lacked only two Ihings. Firstly, advertisement. 



In the years BC (Before CDU) I used to buy the 
Commodore games 'comics' tor the softwate and 
h.irdware adverts. Whal I would like to see, therefore, in 
f DU is perhaps more adverts? Especially from companies 
such as Datel Electronics, etc. Secondly, size - not so 
much a criticism, rather a point of view.'l would like lo 
see more le.atures in the magazine and for this I would be 
willing to pay extra and still consider it good value for 
money. Whal this really points to is that the magazine is 
great, keep up the good work! 
David Brown, Newport. 

Dear David, 

thank- very much for all your kind remarks about CDU 
and ■ lechno-lnlo" in particular. II really is great to receive 
letters like yours because it tells me that I have got the 
iormula for this section correct and I'll do my best lo keep 
it up. Regarding the advertising in the magazine: it jusi 



echelons lhat lie above my head I'm afraid I'm all for a 
thicker CDU - then we could have an even longer 
technical helpline and I'd vote lor that any day. More 
money, you see. Anyway, thanks once again for your 
comments. I hope thai you continue to find CDU 
informative antl helpful. 



OCP AND THE 120D 

Dear CDU, 

Help! Could you please send me information on how to 
configure a Citizen I20D printer for use with the OCP 
Advanced Art Studio. Thanking you in anticipation. 
Norman Merritt, Cambridge. 

Dear Norman, 

Certainly I can. Here are the answers thai you should 
enter lo Ihe questions as ihey crop up: s, 4, 8, t 27 63 8 
480, 27 75 480, %0, 27 76 %0, 0, 13, 0. That should 
lake you to the summary screen. If not then check 
everything again. Enlries like "27 65 8" should he entered 
exactly as shown In the on-screen examples. Thai should 
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DIVISION SUMS 

Dear CDU, 

I need a bit of advice land a devil of a lot of instruct ic 
The attached algorithm for calculating the date of Ea 
Sunday was taken from the "Scientific Americ. 
magazine many years ago. When I came across it the o 
day I decided to try to convert il into a CI 28 urogram 
found il beyond rnv c .ip.iiii lilies. And so I come to yoi 
lew of the steps ask for the remainder of a division sun 
be isolated and others say the same thing about 
quotient. Can this be done on this toy machine of mi 
All the best and my thanks for a good, readable magai 
even if you can'l help me on this occaslonl 
Eric Frost, West Sussex. 



Dear Eric, 

First of all, why do you say that the C128 is a "toy" 
machine? The C12R can be turned, through a few pieces of 
relatively inexpensive hardware, into a very powerful 
machine. Secondly and more importantly, I can help you. If 
you are performing the sum N/D (variable N' divided b\ 
variable 'D'j then vou can calculate the quotient by using 
the formula Q=INT(N/D). This takes just the whole number 
part of the answer. For example, 164/29=5.655 (5, 
remainder 19!. The INT lunction isolates the number before 
(he decimal point so the quulienl can be round quite easily. 
The formula for the remainder is a little more complicated 
bul can be found with a lillle matheinalic al Irickery- K- 
HN/D)- INTIN/Dl) "D, To use the previous ex.imnle n- me 
'N/D'=5.655. 'INT(N/Dt'=-> and therefore the espe-inn ln 
the brackets is equal to 5.655 minus 5 which is 0.(>55. By 
multiplying this by the original number that you were 

find is near enough which is indeed [he remainder. You 
therefore have ihose two equations for calculating the 
quotient, Q, and the remainder, R. Hopefully that will have 



snails very happy A suitable piece or software is marketed 
by GASTROPOD (Gels All Snails Tabulated Releasing 
Overwhelming Piles Of Dalai. I confess I am just a little 
surprised that PAULETTE WES, whose name bears a 
striking resemblance lo (hat of our revered Editor, did nol 
approach him with the business problems as he has shown 
initiative and competence in keeping CDU magazine alive 
with the minimum oi annoyance lo readers. 
NEDWOB (whose name bears a striking resemblance to 
A.H.Bowdenl, Bishop's Stortford. 

Dear Mr.Bowden, 

I musl thank you lor writing in with lhal help for Paulette. I 
presume lhal your lasl remark is a favourable one for Sir 
Eves bul I must admit that I had nol spoiled the similarity 
between Pauletto's name and thai of our great Editor. "The 
world is full of coincidences, isn't it! I'd like also to lhank 
you for the interesting expenditure pie charts tl 
included with your ungual Idler which 

correspondence, such a greal reply lo the spoof le 



SNAIL TRAIL 

Dear CDU, 

If I may be permitted I am sure I can solve at least some of 
I he problems posed by your correspondent PAULETTE 
WES iVolume4, Number 4, Feb 19'Jll. Firstly she should 
tell her advertising manager lhal his salary can slay at five 
figures but in tulure these will be £1 J 1.45 [rer month. The 
employee who took an unscheduled holiday in Germany 
should be told, "We congratulate vou on your personal 



e don' 



ould n 



withoul you bul I'rnm Monday we are going to try!" Aui 
Wiedersehen, Pet (or C64)! Also by allowing your stud 
snails to feed off your neighbour's lettuces you can cut 
feeding costs drastic ally. Software In control the whole 
operation musl be in machine code. This will increase the 
speed of various snail activities, especially breeding 
propensity, and will stimulate production and make a lot of 



TAPE TO DISK 

Dear CDU, 

I'm a C64 owner and ever since I saw your mag I've been 
one oi your many I. ins. Well. I think I should gel straight to 
Ihe point so: 1 ) I've recently bought a I 54141 disk drive and 
I am transferring all my games from cassette to disk. 
However, I'm facing problems wilh the multistage or 
mullili.arl mi whatever they're < ailed! games - the ones that 
when you finish one level, then loads the next one. Could 
'ii . ■■■ .mi helpr .u ;\ heie i .in l i i iii I ., I icHik telling me 

BASIC. Could you publish nr unite iliilkiilt. right? 3) Is 
there a [lossihilits ol tr.insd inning the ILS program for the 
C12B into one for [he CM (I own the ACTION REPLAY 
MkVI - will the SLIST command help!l. Thanking you in 
advance. Keep up with the good work and try to put in 

|ohn Kopsidas, Greece. 

Dear John, 

The secrel lor converting tape mull i load games to disk lies 
in Ihe conversion of tape load routines to disk load 
routines. This is of course a drag to do and su is best left to 
a backup cartridge. You say you have AR6 but that doesn't 
really help because n doesn't cater lor multiload things. 
Trilogii s 1-v.PERT Cartridge will lie able to help vou. II isn't 
really possible to relate machine code commands to BASIC 
ones because machine code is so sort of "raw" and down 
lo the bare minimum. One machine code command may 
require several BASIC ones land vice versa), However, a 
number of them can bediret IK transposed and hopelolly if 
ihe king of all Editors, Paul Eves, has done his job, you 
should find a table elsewhere in the Tec h nod n to sec lion 



i I I lj - 



if the 



Regarding ILS. it is nol possible to convert Ihe program 'for 
use on the C64 direi tly. Another version would need to be 
written, The SLIST command idea might work bul il would 
be ve ry ledious and take an eternity, and besides, the BASIC 
program is very long and you may get an OUT OF 
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MEMORY r-rror w ith the large riumbi'i ut variables usi.il by 
the program. Also, some commands of the CI 28 are nol 
implemented on the C64. II would be besl to wail and see 
wbeihei the author writes a C64 version. 



GEOS COMPATIBILITY 

Dear CDU, 

I hope thai yon can be of some help lo me. I have a (>4C 
and disk drive and a BROTHER HR-S printer. The problem 
is when I load my GEOS disk ami I set everything up lo start 
to wrile, when I gel to prinl what I have lypetl in my printer 
does not work. I have set the printer up as Commodore 
( ouipalihle. Ih this lhal my printer is nol compatible with 
CEOS' I have tried setting my printer with various DIP 
switches but In no good. Have I bought a pig in a poke or 
can you set me in the right rliiei tioni Alio I wonder if you 
can tell me where I can obtain the following books. I have 
asked the publisher but I hey don't ■•el I Ihcm now. Any help 
would be appreciated as I re( kon thai with all the d4Cs that 
are still being sold, other users would like lo gel some 
books to help them. The books are: The Complete 
Commodore b4 ROM Disassembly by P.Gerrard and 
K.Hergin: Impossible Homines tor the Commodore by 
K.Bcigin; Further Adventures I>4. V\ I you still Imv rue 
when I'm &4?, Advanced BASIC and M/C for the 64, Sprites 
and Sound on ihe 64, all by P.Gerrard; anil Sound Uteris 
and Music on the M by VV.Tumei and A.Velta. I lop rig that 

you can be of help. 
H.Lane, Clwyd. 

Dear Mr. Lane, 

Unless your printer is Ihe Commodore version of the 
printer, ie the HR-5C, you will nol gel any results using the 
Comm.Compal primer driver, this is for printers connected 
on the serial bus whii h I presume \our-. isiii allhough you 
didn't say. Vou will need lo purchase an interiace for the 
computer and use .1 different punter driver if you want all to 
work perfectly. The printer should work with the computer 
with a suitable interface. For more information on ihe 
necessary inlerface I would recommend that you telephone 
a company called Meedmore in Merseyside on 1)51-521- 
2202. They are usually very helpful and know what they 
are going on about. Wilh relation to the correct printer 
driver, I would ring Tim Harris at FSSL on 0386-5531 53. 
He'll be able to lake you further on thai side of the 
operation. Regarding the books, the only place I can think 
of is a good lown library. If they are no longer sold by the 
publishers then it is unlikely that they will still lie avail, ihle 
in shops. An alternative, however, loone I can recommend. 
It is "The Anatomy of the Ginimodorr f>4", sold by FSSL. 
which has a compiete l« im disassembly of the 64. 



128 QUERIES 

Dear CDU, 

Last year I pun based a Commodore l .',",[) i omputet which 
has a 1571 disk drive, MPS-801 printer and a colour 
monitor This, is Ihe very first computer I have ever owned. 
This system was chosen above ihe IBM range - ihe reason 
being ber arise it is s u user friendly and I fell it was ihe ideal 



computer for the whole family lo use. I now buy your 
magazine each month. There are a couple of problems at 
the moment that have me confused. Some of your 
programs load in the 00 column mode. What does this 
mean exactly! The other problem is thai on some of them 
they have a less than sign aner ihe file type in ihe directory. 
Vou say thai if one uses a disk editor to remove this 
protection one can then load the program. Please could 
ynu eiplain how one gin's alunit doing I his and also where 
would I gel a disk editor Also, bow does one move the file 
entry to the lop of the direrlory' Could you possibly also 
give me some information on whom I may contact in the 
UK for the purchase oi software by mail. I f iping you can 
be of assistance lo me and also, keep up ihe good work in 
your magazine. 
B.C.. Carroll, South Africa. 

Dear Mr.Carroll, 

The CI 28 has a built-in eighty column mode which is only 
available n you have the nei essaiy monitor or a composite 
monitor with a certain special lead. Programs for eighty 
column mode will not produce any effect on the screen of 
a standard monitor for ihe forty column mode. These 
programs have been s|>ei i.ilk designed wilh an HO column 
screen format in mind. The removal of the less than signs is 
i omplii aled to eiplain in lexl so I have provided a program 
on the disk, filed as PROB, that will do it for you. lust load 
and RUN the program, lollow all on-screen prompts and 
ihen sii hack whilst the protection is removed, after ihe 
program lias located the file in Ihe directory of course. To 
help it do ihis you are asked il you know what sector of the 
directory track the entry can be found in. II is not possible 
li. kiii iw tin- without .1 disk editot le.illy so |lis| press 'N' for 
no and the program will do its stuff. I can only recommend 
I i.i uiu pussibK invc-sl in a back issue if you can and look 

directory manipulation. That article should provide you 
wilh all the information you need for rearranging your 
directories - unfortunately it is too complicated to go into 
here but I hope I have been oi some help already. There are 
many companies in the UK thai sell software and hardware 
by mail. There follows just three (not necessarily mail order 
(ompauies hut they do mail (lungs ii vou get what I mean!) 
that come to mind straight away: DAT EL Electronics Ltd., 
Fenton Industrial Estate, Govan Road, Fenton. Stoke-on- 
Trent, England; Evesham Micros, High Street. Evesham, 
England; 'and now ,i < ompain that i^ ileiiniteb mail order: 
FSSL, Masons Ryde, Defford Road, Pershore, 
Won estershire, WRIO 1AZ, England. If you are looking 
particularly for games software then perhaps you should 
join the Home Computer Club. I've only got an Amiga 
version or their advert, but the address on that is The Hi™ 
Computer Club, Swindon, SNil 4BR, England. 

CHEATS NEVER PROSPER 



a it" mat hine code for si 
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use fa5HJ+ Assembler, Trilogic Expert Cartridge, ond 

enlighlenmenl. CUU is also indispriwil ile and is prubahlv 
as near perfection as possible. Of course CDU should be 
published weeVK and [he low price is too low. My only 
interest in games is what I hey can teach me about coding. I 
have a BASIC loader for a cheat lor Spindizzy. It does not 
appeal to work. GOOD! I don't want to cheat or even play 
Spicn!i//v. I am more interested in what it due-, him it dues 
it. and whv it doesn't. The loader starts as follows: 10 REM I 
LIED, 21) F=67S and then it goes on to read in a load of 
DATA and store it at that 679 onwards. Conerting it all to 
machine code I get: SEI, LDA #$34, STA $01, LDX #S0l>, 
L DA StiTOHA. STA StlOUFA. HEX. BPL somewhere, LDA 
#$37, STA $01, CLI, RT5. Now for the questions. This 
routine is supp. ml In lie loaded beginning .it address fi7 c ). 
M.miliTiiu: resel memoiv I get: 02AS IK) HKK, 02A6 01 01) 
< IRA 'SDd.M OJAH mi Uk'k. I guess that 02AF> 1)1 Of) ORA 
fSOO.Xi is there lor the benefit of the C6-1 or perhaps is a 
product of the cartridge used to reset memory. Question: 
What is 02A6 (11 1)0 ORA ISOO.X! ior'. Loading the short 

problems for address 02A6 because the ne*l address i. 
02AB - il is supposed to load Jl 02A7 which is obvii.iusk 
wrong because the instruction at 02Ad lakes two bytes. So 
should I move it to 02AB and SYS it at (.BO decimal? The 
machine code routine sets the interrupt flag, alters the 
memory layout, copies some locations across then resets 
the memory map to default. More questions: I think it is a 
spool. Hence the REM slatemenl 'I LIED' in the loader 
because it just appears to copy blank memory to blank 
memory. Am I wrong? If so, what does it dof The only 
thing I can say is that bit 2 of location I is zero. Apologies 
fur the garbled nature of this letter, I normally use 
GeoWrite bul mv printer's not well. Thanks for any help. 
|im Wyatl, Derby. 



Dear Jim, 

Glad you think that CDU is near perfection. Sorry it can't 
be published weekly thought To answer your questions, 
you have firstly misinterpreted the machine code I'm 
afraid. You have not taken into account the lo-hi byte 
storage system- The commands that you identify as LDA 
S07()H..\ and STA S0ODF.X are in fact LDA Sl)tto7,\ and 
5TA $DF00,X. This then perhaps makes more sense 
because the codes ior the "I LIED" statement will lie poked 
into memory high up. 5pindizzy would I presume check 
this location high up in memory to see whether the text 
was there, [f so, cheat mode enabled! I don't think that il is 
a spoof, li it does not in fact work then remove the space 
before the REM and the "I*. That may then help the 
proceedings. The reason why you get spurious results 
upon resetting and reading memory is that the area in 
question is filled with null and important bytes when the 
machine is reset. Nothing can be stored there permanently 
so to speak, like il can at places elsewhere in memory. By 
permanently I mean the code will still be there afler a 
reset, not after switching off and then on again. The code 
thai you disassembled means absolutely nothing and is just 
the null byte information. To summarise then, the program 
i- probably all right and seems to do something and it is 
jusi ib.it that section of memory is reset itself upon resetting 
of the machine. 



110 VOLT PRINTER PROB 

Dear CDU, 

My problem is with a STAR NEX1000 printer that was 
purchased in the USA along with a CD Grappler. This 
system worked perfectly on my brother's Commodore 64 
system IN the USA, but when hooked up similarly iwilh 
Ihe :i:i| mipriate 1 10 volt power supply) and using the same 
PRINTSHOP package, as again used in the USA, printing 
oc c urred but in a haphazard manner. I have enc losed ,i 
copy of a letter heading using this system for your perusal 
and any comment you would care to make to rectify this 
problem would be appreciated. I do recall, but as this lime 
cannot find, a problem being slated with a STAR printer in 
a previous issue of CDU where it was slated, as I 
remember, thai the 'internal clock' was causing the fault. 
Could this be? If so, what is the remedy as it seems to me 
that all talk of compatibility with Commodore Ms by STAR 
is hi ,i' i v.,ish. Not thai it isn't a good printer, it's superb, bul 
my MPS-801 is far more compatible. I will close with a 
heartfelt thanks to all your staff. Pick at this letter as you 

A. j.H lack well, Northants. 

Dear Mr.Blackwell, 

First of all I must thank you for sending in a sample of what 
was going on with your printer. It certainly would seem 
thai il is ihe internal clock that is playing up because each 
time you produced Ihe letter head, it was doing the same 
■-■•In' " points to ,, lauil lh.il is run jiH random. Il is 
due In the USA supph hi in;.- -i\H hertz lie. |uency and not 
jf'lHz like it is in the UK. The voltage is only one part ol 
the problem. The printer will be expecting a frequency 
higher lhan that given to it which will, in simple terms, 
confuse it. I think that Tandy shops sell converters althuugh 
most large, good elecldcal companies will be able to tell 
you the best thing to buy. You need a supply frequency of 
>t)FH/. Failing that I can't see why Ihe printer is plating up. 
Regarding STAR compatibility - I can say with total 
i (inlidenc e lhat talk of ( ompaiibility with Commodore is 
NOT hqgwash. I have a STAR LCI 0 printer myself and am 
mnsi satisfied with it. II winks with every pciniing program 
that I have and as of yet I have come ac ross no problems 
with it. With a bit of luck I will have been of some 



DISK FORMATTED? 

Dear CDU, 

First of all, from February - happy birthday to Tec lino- In to, 
and long live CDU! Here is my problem: in a BASIC 
program cji my own (C64 and 1541 1, I need to write a dala 
file to disk. Past experience told me lo beslighlly c autious, 
■o I mid I hi' program In perlorm some tesls befuie wrilmg 
the file. I'm able 10 test the following wilhin ihe program: If 
the drive is on, if there is a disk in Ihe drive, if the file already 
esisis jnil needs lo lie sc ratched. But I'm not able Id test if the 
disk in the drive is olie.uk lormaited. < mild you help? 
Roland Dept, Belgium, 

Dear Roland, 

The only way to check whether or not a disk has been 
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Inim.illHl lh.it is alsii i*\ in under-land is l>\ .illvii i| M ■ 1 1 '" 
load the directory, li you get a redd error rhen il i- prob.il >k 
that the disk hasn't got a directory and is therefore not 
Kirm.illud. ( )lhcr i rn umsl.mi cs i null I h j r i p i ^ rilnu.il the Mini' 

results but I should think thai this mrthod wul suffice Execute 
the line: OPEN 13,6,13: OPEN 2,8,0,"$": INPUTS1 5,E: 
CLOSE 2: CLOSE 15. If It ends up that the variable E is not 
■tero - chert: whether il is thf t'tnir v.ilue tor noe oi the read 
errors that can be round in your drive's manual - then an error 
has occ urred ami you may assume that the disk is worth 
formatting because it can't find a directory. 



UPDATE 

Now to this month's Tech no- 1 nib Update. There is just one 
thing la report back on. MR SIMON COLLINS OF NORTH 
HUMBERSIDE has informed us of the F'OKEs that MR 
SANDERSON OF SOUTH AFRICA was after in the 
December 1990 issue. They relale to the game 'GAME OVER' 
,ind provide ■nriniti' m - mi it. Vn.j -in mid luid uii Use _: . i r i i • ■ 
reset the computer, and then enter: POKE I 5244,2 14: P( )KI 
15245.2J4: SYS2.1U4. Thanks very much lor that little hit til 

help, Simon. 



TIP OF THE MONTH 

This month you are going | (1 h JV( . t ( , p„| „p w \\h ,-, f |p f r( , m 
me I'm afraid. Please keep those tips rolling in and I shall 
publish any that will In- ui gcru'r.il interest to the readers. But 
for now, I'm going to give a few hints out to users of BASIC. 
In all the reference books that I've read there is always 
something lo the effect "The programmer should ensure that 
loops are complete before lie breaks out of them" but it 
never tells you how to go about that. Following are just a few 
little simple hints for BASIC: programmers. Imagine you have 
the following program: 

10FORT=1 TO10 

20 IF AS(TI="END" THEN .50 

30 NEXT 

40 PRINT "NOT FOUND": STOP 
SO ...rest of program 

This would exit with the BASIC slack confused. II is the same 
as performing a GOSUB and then not RETURNing from it 
properly (Try RUNning the following: 10 GOSUB 10 - the 
computer gets confused because you never have a RETURN 
command executed correctly). Always ensure that fur every 
GOSUB there is a RETURN. Errors occur if there is a 
RETURN without a GOSUB but nol the other way around. 
Be careful. But back to the loops. |usl use a flag: 

10F=0: FORT=l TO10 

20 IF AS(T)="END" THEN F=1:T=10 

30 NEXT: IF F=1 THEN 50 

40 PRINT "NOT FOUND": STOP 

50 ...rest of program 

Many of you who already write complicated BASIC 
programs will have thought that that was below you. lust go 



back and check your loops and 1 bet you'll be surprised how 
many times you jump nut of loops without finishing them. 

Finally, if your program pauses for a while now and then for 
no apparent reason, il is because all unwanted variables are 
being disposed of. To rectify it, execute the command 
G=FRE(0) or similar (by that I mean the variable 'G can be 
changed) at regular intervals. If your program has a menu, 
uiw Ihe command just before the menu is displayed. In that 
way you will get a number of very short pauses instead of 
one or two very long ones. 

I hope that a lot of you will find those quick tips useful. 
Remember tlvat if you do have any tips then send them to me 
at the normal Techno-lnfo address for publication. What's 
more, if you have any hardware or programming problems, 
no matter how complex they may seem, please do not 
hesitate to write to us and we'll do our best to sort tbem out 
for ynu. The address is, as always: CDU TECH NO- INFO, 11 
COOK ClOSE, BROWNSOVER, RUGBY, WARWICKSHIRE, 
CV21 1NG. See you all next time when il will be |une, the 
month of my birthday - so I expect lots of cards to arrive by 
the first!! See yer then. 



Some machine code commands and Ihe equivalent BASIC 
statements for |OHN KOPSIDAS OF GREECE: 

ADC flxx; A=A+xx+C: IF A>255 THEN A=A-256: C=1 

ADC xxxx; A=A+PEEK(xxxx)+C: IF.. .THEN as above 

AND flxx; A=(A AND xx) 

ASLA; effectively A=A*2 

ASL xxxx; effectively POKE xxxx, PEEK(xxxx)'2 

BCC vxxx and BCS xxxx; IF C=0 THEN xxxx and IF 

Ol- 
eic and SEC; C=0 and C=1 
CMP #xx f/b FJEQ xxxx; IF A=xx THEN xxxx 
CMP xxxx f/b BNE yyyy; IF PEEKIxxxxloA THEN 

yyyy 

CPX #xx f/h BEQ xxxx; IF X=xx THEN xxxx 
DEC xxxx; POKE xxxx, PEEK(xxxx)-1 : lo 255 if =0 
INC xxxx; POKE xxxx, PEEWxxxxM: to 0 if =255 
INX and INV; X=X+1 and Y=Y+1: check as for ADC 

in 

|MP xxxx; GOTO xxxx 

JSR xxxx; GOSUB xxxx 

LDA#xx; A=xx 

LDA xxxx; A=PEEK(xxxx) 

LDA xxxx,X; A=PEEK(xxxx+X) 

LDA(xx),Y; A=PEEK«PEEK(xx)+PEEK[\x+l)*256)+Y) 

LDX/LDY as appropriate for LDA 

LSR as for ASL but divide not multiply 

NOP very short pause 

ORA#xx; A=(AORxx) 

ORA xxxx,Y; A=(A OR PEEKIxxxx+Y)) 

RTS; RETURN 

SBC #xx; A=A-xx 

STA xxxx; POKE xxxx.A 

STA xxxx Y" POKE xxxx+Y A ' 

STA <xx|,Y;' POKE (PEEK(x\)+PEEK(xx+1)*256)+Y,A 

SIX sn as appropriate for STA 

TAX and TXA; X=A and A=X 

TAY and TYA as for TAX/TXA 
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NUMBERS AND BYTES 



Another excursion into the arithmetic of our computers by joHN SIMPSON 



The f hirrl In 3 series of single pal discussions dealing 
witn most aspects ot uingMnming iomp„ters I hit 
disiusvon deals with f.e \nd. ) me"l.il. ,,: Ft ■ „r, Coded 

Decimal sen: 

ihe 'its: prim Ipfed n i.-i .. n: m i J - 10 eniudi- mc(i 

dmirwl digit scua'.ileiy To do This will n-rjuire the \nt. 
□f four binary bits, or a half byte (commonly referred to 
as a nyble). As you may rememher from an earlier 
discussion, a nyble can hold the decimal represenl.il ion 
"I il ihrough 10 15, but as we new only require- the digits 
0 through to 9 for decimal, the representation of 10 
through to 1 5 can be disregarded, see table 1 . 



BITS 


DEC HITS DEC 


0000 


0 1000 8 


0001 


1 1001 9 


0011 


2 1010 unused 


0101 


3 1011 unused 




4 1100 unused 


0101 


5 1101 unused 


0110 


6 1111) unused 


0111 


7 1111 unused 


TABLE 1 




■■■in_ 


a full byte size we 




from 0 Through to 4 



1 BCD, represent rhe 
is "1001 1001". For 
larger numbers we simply add more nybles lo meet with 
rhe required size of the number. For example, lei u.s use 
the number 49,382. In this example we will require the 
"-e of 5 nybles, or 3 bytes (the final nyble being left 
0 represent our 5 digit decimal number. 



unused), li 



Byte 2 Byte 1 Byte 0 
000001001001 0011 1000 0010 



9 3 



When « 



e wish to operate the computer in BCD mode, 
we must inform Ihe processor of our intention. This is 
ea>ilv done by setting Ihe dei imal flag lo Irue (1), which 
is btt No 3, in the Status Register. There is an Assembler 
uiilcd instruction lor this purpose, namely "SED" (SEt 
Decimal mode). The effect of this will ensure that during 
arithmetic operations on bytes, an "internal" carry, or 
borrow, will he generated vj that ear h nvhle will run 
represent numbers beyond 9. 

For example, if a byte contained the BCD value of, say, 
27 (0010 0111) and we were to add 6 to this number, 
then as soon as the Lo nyble reached 9 a carry to the Hi 
nyble would be generated making the byte value 33 
(0011 0011). ' 
If our original example number was 97 and we added the 



6, then when ihe carry from the Lo nyble is added lo Ihe 
Hi nyble. this would cause a further carry to the eighth 
bit, nr. effectively setting the carry flag. (0000 001 I - 
C=l). A1 Ibis point we would need to take account of Ihe 
carry Hag. and if we wanted numbers greater than 99 we 
would need to incorporate another nyble and add ihe 
carry to this, and soon mm H Oiou ooll - 103). 



This leads us on to signed BCD numbers. Deciding upon 
the size of Ihe numbers we require we can "put aside" a 
section of bytes to handle the maximum size, and by 
adding an extra nyble for use as e.ilher the positive or 
negative sign of Ihe number. To indicate how many digits 
are being used it is also possible to incorporate an extra 
nyble, or byte (depending on quantity), to specify this. 
Here is an example of a multibyle BCD signed integer: 

0 3 0 7 4 5 (3 Bytes) 

number 

"745" 
Sign of 
number 

0000 = positive 

0001 = negative 

Quantity of 



Fractional numbets can also be represented using BCD. 
For example ihe number +7,45. may be represented by: 

03020745 (4 Bytes) 



decimal point 
is on the left 

The great advantage of Bi 
slow arithmetic operatiot 



is 01" prime importance. There 
where unsigned BCD is used 
usually within rhe games 

Okay, then, this wraps up I 

has helped clarih -.ome »■ 
systems and their effects 01 



heie absolute accuracy 
■ also many other areas 
great advantage, more 
^nt for keeping tabs 

he final discussion, I hope thai 
; realms of Numbers and Bytes 
the aspects of Ihe numbering 
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ASIC 



Now you can develop your own Business programs with ease by FERGAL MOANE 



easy to learn i 
management is 



full WIMP en' 
<B K? bur sti II " e 



mted to writing ^serious' prograr 

J debug, and a great deal of m 
]ne for you. Arrays and strings ai 
lipulate. Unfortunately, Basic 2 

in. It's fifty-odd commands give 
nment and assist with I/O and v. 
las an interpreter as latjje as the 
s you with 34K for yourself! 



02A7-02CC TEMP. DATA AREA 



0300-03FF 
P.400-07E7 
07FB-07FF 
0800-8FFF 
9000-9FFF 
AOOO-BFFF 
COOO-CFFF 
DOOO-DFFF 
EOOO-FFFF 



COMMAND VECTORS AND BUFFER 
SCREEN 

ICON POINTERS 

MAIN BASIC AREA (34K) 

INTERPRETER AND COMMAND CODE 1 

BASIC ROM/WINDOW STORAGE 

COMMAND CODE 2 

VICSIDCIA IO 1+2 

KERNEL ROM/FREE STORAGE AREA 



POINTS TO NOTE 



BUSIBASIC USERS GUIDE 



An alphabetical summary of commands follows. Error 
massages are discussed and a command summary is 



1) All ordinary programs will work in the Busibasic 
environment, but nbtii.iuslv Busibasic programs will only- 
work with Busibasic present. 

2) There are a number of commands which use the 
-Went interrupt. These will not operate at the same time, 
and the last executed command will have priority. 

31 Watch out for Basic strings corrupting Busibasicl 
Locations 52 and 56 should always be below 144. A 
crash will nearly always he the result of corruption. 



MEMORY ALLOCATION 

Allhoiij.;h Busibasic takes up a huge 8K of RAM, you are 
Ihi uith (4k free for Basic. The area from SCDilO-SDlM" i 
and $9OOO-$AOO0 are strictly reserved and any attempt 
lo overwrite these areas will crash your program. Zero 
Page is used extensively, especially locations $F6-SFE. 
There is no room in the machine for any other machine 
i ode. except liy lowering Basic. 

Busibasic has no preference for screen and graphics data. 

ir location for graphic 



The dollar sign allov 
in variables, express i 
hex number by the dollar „ 
equivalent will be calculated and processed. 
EG. SYS $9400 

POKE SDOO0.SFF 

PRINT SFF 



ids v! 



adjust accordingly. 



I detect the n 



The percent sign followed by ; 
the use of binary constan 
especially useful in setting indi 
EC. POKE 54296,7,10001011 



Binan 
■iflu.il his 



n location and 



MEMORY MAP 

HEX LOCATION DESCRIPTION 



0000-00FA 
0OFB-O0FF 
01 00-02 A6 



hash; workspace 

BL.'SlhASIC PA RAM I- ITR BLOCK 
STACK AND ZERO PACE 
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eluded for compatibility with other DOS Support ARROW 
ograms.See DOS for a full description of syntax. 



See also: .PROC .ENDPROC 

DEFPROC defines a procedure. Anyone who has used 
flliC H.Tiii will know how uselul a pro, erlure is. It is in 
• ll-r I .1 111 i';i in .i ;i.i:.i.i' 11,1111 lip' ..: dii. 

parameters passed to it. .DEFPROC defines a procedure 
with the name procname. This name can be up to 128 
characters long and is used to reference the procedure 
with the .PROC command. The optional parameters 
allow variables Id be spec ii'iecl insult' brat kets separated 
by i omnias. These v,n iables i .111 he passed from the main 
program to the procedure and used there. 



ARROW allows parameters to be specified for the 
POINTER command. The smaller the speed value, the 
faster the pointer moves. The colour parameter follows 



EC. 10 



70 



.DEFPROC WAIT(N) 

Tl$="000000" 

IF INTCFI/60) < N THEN 30 

.ENDPROC 

.PROC WA1T(5) 

SEC=10 

.PROC WAIT(SECi 



the 



d for e. 
s po5s 



,l Hi . 



.PROC 

Syntax: .PROC p roe name (optional parameters! 
See also: .DEFPROC .ENDPROC 

.PROC references a previously defined procedure wilh 
the name procname. Conlrol is passed lo the procedure 
and any variables transfer red. Execution resumes at the 
nest command after the .PROC when a .ENDPROC is 
encountered. It is similar to the GOSUB/RETURN 
construction. Note lhat Ihe correct number of values 
must be supplied, but these may be different variables 
from the ones specified in the DEFPROC command. This 
gives increased flexibility. See the example above. The 
procedure stack can handle around 25 procedures fll 
once. See the error message dictionary. 



BAR 

Syntax: BAR screen luialinn.i nlour.heighl 
See also: LOCATE BOX WSTORE WDISPIAV 



B'\k ilr.nvs a vertical 



d bar with resolution of one 
graphics, and is therefore 
:. The bar is always eight 
the number from 1024 to 
1 ihe screen matrix. Height 

■ quickly. It is invaluable 

omhined wilh bines and windows. 



t ompjlible with ordinary I 
dots wide. Screen location 
202A where the bar is to sta 
is in pixels: This comm; 
histograms 10 be drawn v 



This procedure allows a program to be paused for a 
certain number of seconds. The procedure is t ompleleiy 
independent of the main program. It is impossible I" t;ive 
a lull explanalion of procedures in this small space, but 
see the demo program for examples. 



See also: BOFF 

BEEP sets up a 'blip' once a key is pressed. This facility is 
found on expensive compute's, and i;ivrs programs thai 
proiessi onal iolk h. It is interrupt driven and will c, intimit.- 
until RUN STOP/RESTORE is pressed, BOFF is executed, 
or it is cancelled by another interrupt command. 



.ENDPROC 
Syntax: .ENDPROC 
See also: .DEFPROC .PROC 

.ENDPROC specifies the end of a procedure. 
.ENDPROCs are paired with the last .DEFPROC. Note 
how the area of program marked by a 
.DEFPROC/.ENDPROC is completely ignored until it is 
Jled by a .PROC command. I'n.n edures have a in 1 1 -stop 



BINPUT 

Syntax: BINPUT,X,V,"promp( string", length,variable 
See also: 

Busibasic INPUT is an extended INPUT command. Tl 
Commodore form can be crashed easily and has 
number of weak points. This allows the input of a vak 



:nng o 



iable. 



it exceed trv 

length given, Edi.ing is supported, but the cursor canno 
move out of the given area. Once RETURN is pressed, 
control is returned to your program, with the variable 
specified containing the input. Note that the p 
string is optional. 



BOFF 

Syntax: BOFF 
See also: BEEP 

Thin command switches the keybeep off. It will 
any other undesiied inteirupl commands and rt 
HIV to normal. 
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See also: WSTORE WDISPLAY 

BOX draws a character graphic box of the 



□APPEND 

Syntax; DAPPEND"filen 
ciffed See also: DLOAD 



DAPPEND joins a program from disk 

one currently in memory. This allow; 

tried and tested subroutines on disk to be appended tt 
your latest program. Try and make sure that the lint 
■ numbers .ire diflcreiil ur problems could occur. Use ihi 
I DLIST command to make this check 




DIR displays the directory or the disk in the drive 
directory can he slowed by holding down the CTRL 
DUST 

Syntax: DLIST"filename" 
See also: TYPE 

DUST will list the Basic program spec i tied directly from 
disk. This means that the program is not loaded, and 
other program* can be examined without disturbing the 
currem H.nsii: program. Lines can be fibbed b\ D LI ST i it,.; 
to the correct place, pressing 5TOP and pressing 
RETURN over the correct lines. This has proved to be a 
very useful command. See TVI'L loi listing other lilMvpes. 
Note that DLIST is not very reliable with control 
characters or BUSIBASIC commands. 



CLINE 

Syntax: CLINE linenumber 
See also: CLS IOCATE 



DLOAD 

Synatx: DLOAD "filename" 
See also: DSAVE DAPPEND 

DLOAD merely loads the specified Basic program from 
disk. No ,8 is needed alter the filename. DLOAD"*" is 
much neater than LOAD" - ", 8 



CI S simply clears the a 



DOKE 

Syntax: DOKE locatio 



ns a double-byte POKE. It will split the 
-j high and low bytes and store them 
location+1 in the correct order. This 



COLOUR 

Syntax: COLOUR ci 

COLOUR simply se 
without having to us 
locations. 



DOS 

Syntax: DOS "command" 

OR DOS 

OR DOSS 
See also: @ DIR 

DOS is a multi-function coi 
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operating system. DOS"command" will send any 
command Thai wnuld normally be sent by 
OPENlS.B.lS^command^CLOSE 15. Il allows the 
scratching and copying of files etc. See the drive 
handbook lor more im'orriuitic jn. These commands are 
essential when working with business programs. 
DOS will display the contents at the disk error channel in 
reverse video. Il will explain the cause of the flashing 
LED on the drive. DOS should be used after every major 
disk access. 

DOSS will display the disk directory to the screen. See 
DIR for more information. 



DSAVE 

Syntax: DSAVE"filename" 
See also: DLOAD 

Saves the current Basic program lit disk with lhe specified 
filename. A save with replace can be executed by 
placing @0: in front of the filename. 



DUMP 

Synatx: DUMP 
See also: FKEY 

F'erlorms ,1 dump of the lexl sown to a device 4 printer. 
This is a relatively fast method, and takes care ol ASCII 
conversions. If a printer is not connected, the screen will 
be dumped to the' screen! You may like to assign this 
command to one of the function keys for a one-key 



FAST 

Synalx: FAST 
See also: SLOW 

FAST increases the processor clock rate by switching off 
the screen and sprites and setting interrupts to a 
minimum. A speed increase of around 10"-. is usual. This 
is useful in speeding up operations where lhe sc reen is 
not necessary. 



FKEV 

Syntax: FKEY"F1,F3,F5,F7,F2,F4,F6,F8" 
See also: BOFF 

FKEY will assign your own definitions to the eight 
function keys. The function keys are already defined by 
Busibasic as below: 

F1 - DOS 
F3 - DIR 
F5 - LIST 
F7 - RUN 
F2 - DLOAD 
F4 - DSAVE 
F6 - OLD 
F8 - QUIT 



SYS S941K1 will restor 


a these definilions 


fter RU 


SIOIYKFSTORE. BOFF v, 


ill disable the functio 




When defining your ov 


n function keys, ther 




ach key. A carriag 




signified by a back arm 


n. Separate each def 


monb\ 



ICON 

Synatv: ICON icon number,ftag 

See also: SETICON POSICON PTRICON 

ICON enables or disables one of eight icons. Icons run 
from 0-7 and are sprites. They follow all the rules for 
sprites, and lhe four ICON commands lake the place of 
the dozens of pokes necessary for sprites. Icons can be 
il.-Mgni'd with ,inv sprite editor. They are useful in pivinf; 
,i graphic representation of a program or operalion and 

Programmer's Reference Guide for an easy introduction 
lu ii i ins/sprite- .mil lhe let huii|ue- assot idled with them, 
["lag delvr mines whether the icon is to be switched on or 
off ■ 0 is off and 1 Is on. 



INSTRING 

Syntax: INSTRING target string, search string,result 
See also: VARPTR 

INSTRING finds the occurrence of one string within 
another string. It is useful in anything requiring a search 
facility. The target string is compared with the search 
string, and the tirst m < urrence til" the search string w ithin 
lhe l.irget shine is noted. Tlii- value is pawd 1>,k k m lhe 
result variable 

EG. INSTRING A$,B$,RESULT 

Result will now contain the position of the first 
occurrence of BS within A$. 



JOY 

Syntax: JOY 

See also: BOFF MENU 

IOY provides a useiul editing i.uilitv. Il allows you to 
position the cursor by using a joystick in port 2. It 
simulates the appropriate cursor key press, and can 
therefore be used within programs requiring cursor 
movement. It is interrupt driven so BOFF will disable 
|OY. The fire-button simulates the RETURN key. 



KEYWAIT 
Syntax: KEYWAIT 

KEYWAIT will wait indefinitely for a keypress. This saves 
the use iif GFT and is useful in many apijlic alioiis. This 
command is not ideal for receiving a value from the 
keyboard, but location 2 Will contain the value that 
would have been in location 147. See a reference guide 
for details of these values. 
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LOCATE 

Syntax: LOCATE x,y 
See ahojCLINI 

I OCA. IK |Hisi lions ihf i ursor .H the vy position where >. 
is less than 40 and y is less than 25. Use this in 
( on|iin<lion with the print command ior accurate lexl 
positioning. It is faster and neater than cursor commands 



LOWER 

Synlax: LOWER 
See also: UPPER 

LOWER switches to [he Ch-t's lower-cnse business mode 
character set. This reduces the graphics characters 
available to you, hut is cMinli.il fiji wordprocessing. 
Noli' lli.il graphics characters used in BOX and RAH may 
he j fleeted. This command should be avoided if you are 
moving your character sets. 



MENU 

Syntax; MENU return vartabk'%, choice ar ray (0), zone 
See also: WSTORE JOY 

MENU creates drop down menus similar to those kXJ 



to the screen. OLD is a very useful and reliable 
command which will save some angry words. 



POINTER 
Svn1.ix: POINTER 
See also: ARROW JOY 

POINTER will display a joystick driven pointer on-screen. 
It is controlled hy the port 2 joystick and cannot move off 
the si reen. The routine will lake control of your program 
until the fire button is pressed, indication lhal a screen 
item has been selected. You can then get three items of 
information about the pointers location. 

251 - X co-ordinate 0-39 

252 - Y co-ordinate 0-24 

253 - screen code of character under cursor 

PEEK the above locations to find the correct information. 
The X and Y co-ordinates are most useful as they relate to 
screen positions rather than sprite positions. Use this 10 
decide which action to take. 

The cursor speed and colour can be changed with the 
ARROW command. Note that the pointer occupies one 
of ihe eight icons available. 

The cursor keys and space can be used 10 control the 
pointer, 



option is highlighted in black. Control is returned to your 
program once a choice has been confirmed by pressing 

Zone ranges between II and 4 .lrul determines where the 
menu will appear on screen. 0 is flush to the left border 
while 4 is flush to the right border, 

eg.MENURT%,A$(0),2 

MENU stores it's screen information in the same area as 
the window commands. To avoid corrupting windows, 
create a dummy window ivhh h tills the screen. This will 
take up the correct amount of space for the MENU screen 
store, and avoid touching other windows. You should of 
course not use that particular window. 



OLD 

Syntax: OLD 
See also: QUIT 

OLD will resurrect a Hasic program after a reset or a 
NEW command. It will restore pointers and give ,1 listing 



ubroutine. Subroutines ( , m |>,, hr.int hed out of, but the 
eturn address is left on the stack and clogs it up. This 
esults in an eventual OUT OF MEMORY error. POP 
.Mows the program to ignore the existence of a 
ubroutine. This means that POP is used just befure a 
ump tiul of a subroutine. This might just be a saviour to 
our program strut: lure I 



POSICON 

Synlax: POSICON icon number.X.Y 
See also: PTRICON ICON SETICON 

This command Positions an ICON. The icon number is 
the standard identifier from 0-7. X and Y are in the 
normal sprite ranges. Expetiment to find the border 
positions on your monitor. There is no need to fiddle 
about with Ihe MSB of X - X numbers over 255 will be 
automatically calculated. Note that the other three 
commands must be used before the icon becomes 
visible. 



PTRICON 

Synlax: PTRICON icon number,design block 
See also: POSICON ICON SETICON 

PTRICON sets the PoinTeR to the appropriate ICON, This 
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starts in memory. The design block is calculated by 
dii iriinu the address from the start ol [he b.ink by 64. For 
iiinsl ations where hank 0 is in use. just divide the 
address by 64. 

eg. 122B8 /64 = 192 

start address/ &4 = design block 



QUIT 

Syntax: QUIT 
See also: OLD 

QUIT will return In the norm.il Commodore operating 
system. It will make Busibasic invisible to Ibe system, but 
still in memory. Basic programs are not affected by the 
QUI I ( ommand. You can return to Bus ifi.i-.ii bv typing 
SYS .nm. This means that you can exit and return to 
Busibasic at will. 



REVERSE 

Syntax: REVERSE screen location, number of characters 
See also: ClINE 

REVERSE toggles specified characters between reverse 
and ordinary mode. This is useful lor highlighting a title, 
or lor drawing .5 bar. It is thousands of limes i.isier lhan 
it's Basic equivalent. The screen location should be the 
number between 1024 and 2024 in the screen matrix 
where the reverse should start. The number of characters 
is obviously the number of screen positions that should 
be reversed. This could be useful in conjunction with the 
POINTER tn indicate what has been selected. 



SETICON 

Syntax: SETICON icon 

number,lype,colout,Xexp,Yenp,priority,eolc)iir1,colour2 
See also: POSICON PTRICON ICON 

SETI("( IN sels up parameters for icons. The type should 
be 0 for hi-res and I for multicolour. Colour is obvious. 
Xeiip ami Ye\p determine ii e'pansioii is swilihed on 
or off on Ihe icon. 0 for off and 1 for on. Priority dirlales 
the priority of the icon over the background, 0 
bai kground and 1 icon. The two following colours are 
only Specified if the icon is in multicolour mode. All 
colours are from 0 to IS. SETICON should be used along 
with the other commands to make an icon visible. 



SLEEP 

Syntax: SLEEP lime 
See also: 

SLEEP makes your program pause for a specified amount 
of time. This allows the user lime to read displays etc. 
and avoids the use ol clumsy FOR. .NEXT loops. The time 
should be between I and 255. For a rough guide, 
multipk the lime figure by 4 for the time in seconds. This 
of course varies witb the interrupt rate. 



SLOW 

Syntax: SLOW 
See also: FAST 

SLOW restores the screen and reverts to normal speed 
after a FAST call. It should ONLY be used after FAST has 
been used. This Is because FAST stores essential 
information in the parameter buck at 251. If this has 
been corrupted by other Busibasic commands, the 
SLOW command will crash the C64, 



SORT 

Syntax: SORT array name 
See also: VARPTR 

SORT performs a speedy sort of a string array into 
alphabetically ascending order. This is a very useful 
command in business programs. The array name should 
only be the first one or two letters of the array name (i.e. 
no $ string identifier). The array should be one 
dimensional and have more than one element. See the 
error messages for more information. 



TVPE 

Syntax: TYPE "fi I ename.fi I elype" 
See also: DUST 

TYPE displays the contents of a file directly to the screen. 
This often results in rubbish, but it is very successful with 
sequential files. Hasa programs should be displayed with 
the DLI5T command. The filetypes are shown below: 

P - program 
L - relative 



UPPER 

Syntax: UPPER 
See also: LOWER 

UPPER relurns the C64 to the default capitals/graphics 



VARPTR 

Syntax: VARPTR variable.return variable 
See also: SORT 

VARPTR will return the start address of the variable. It 
will store the address in the return variable specified, 
rhis i omnia nd is limited in it's usefulness. 



WCLR 

Syntax: WCLR 

See also: WDFLETE WLOAD 

WCLR clears ihe area under the Basic ROM for the 
storage of windows. Il MUST be used before any window 
commands, and it is wise to include it at the start of your 
program. The windows will not work without first being 
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CLeaRed. This does nol apply if you are loading in 
previously created windows. 



WDELETE 

Syntax: WDELETE window number 
See also: WCLR 

WDELETE will delete the specified window from the 
buffer. It will tree up memory lor oilier windows. Make 

WINDOW ERROR ' '** V "'^ °' ^ " 



WDISPLAY 

Syntax: WDISPLAV window numher,X,Y,flag 
See also: WSTORE 

WDISPLAV displays a previously stored window to the 
screen. A copy of the stored window is left in Ihe buffer. 
The window contents will be displayed at ihe X and Y 
cursor position specified. This is flexible, as the X and Y 
positions (or displaying need mil be ihe same as those 
when storing the window. 

Flag has an important bearing on how the window will 
be displayed: 

flag= 0 the window will overwrite the screen 
flag= 128 (he window will have reversed colours 
flag= 64 the window is swapped with the screen 
flag= 192 the window will have reversed colours 

repeating llu- i ommanrl will restore liie original display 
, liter the window has been used. 



WLOAD 

Syntax: WLOAD"fiiename",8 
See also: WSAVE 

WLOAD will load a previously stored set ot windows into 
the buffer area under the Basic ROM. This means thai 
windows can be created and stored outside your 
program, and your program can access them as they are 
needed. The inclusion of this command means that the 
number of windows i, only limited by disk space. Note 
that WCLR is nol necessary if WLOAD is used. 



WSAVE 

Syntax: WSAVE" filename", 8 
See also: WLOAD 

WSAVE saves the BK window buffer area under the Basic 
ROM to disk. Windows can lie c reated and stored outside 
of your program, and WLOADed when needed. This 
shorten* your program, and provides scope for a huge 
amount of information to be stored on disk anrl ai i essed 
when required. WSAVE will only save the number of 
windows that have been used, therefore using as little 
disk space as possible. 

WSTORE 



Syntax: WSTORE window number,X,Y,widlh, heigh 1 
See also: WDISPLAV BOX 

This command is the heart oi the window operating 
system. It stores a specified section of the screen lo an BK 
butler, assigning il a unique window number. Note that a 
border is not drawn around the windows, the BOX 
command has been designed lor Ibis purpose. You should 
make sure that all parameters are correct or you will get a 
WINDOW ERROR. See the Error Dictionary for an 
explanation oi the numbers. Be sparing with your width 
and height settings or you will run out of memory. 



ERROR DICTIONARY 



Busibasic issues it's own errors, as well as modifying 
some existing ones. The error c lurking in mosl routines is 
secure, but you should calculate correct parameters 
beforehand to avoid mistakes. An explanation of errors is 
given below. 



( ARRAY NOT FOUND 

A string array has been referenced in a SORT command 
whi< h (Joes not exist. Make sure that your array has been 
dimensioned properly. 



'.END WITHOUT PROC 

An .£M"JI''KOC has been found without a corresponding 
.DLl PR( >C. This is similar to (RETURN WITHOUT 
("lOSl it). Mkae sure that all procedures have assoc. idled 
.DEFPROCs and .ENDfROCs and you will have no 
bother. Note that the line number specified is the line in 
which the procedure has been called by .PROC 



(ILLEGAL VARIABLE 

An array variable has been used as a parameter in a 
procedure. This is not allowed. 



(NO .END FOUND 

A .DEFPROC has been found but with no .ENDPROC 
associated with it. Always close each procedure with a 
.ENDPROC 



(NOT ENOUGH ELEMENTS 

A string array has been spec ified in a SORT statement and 
it lias only one element. An array of one string cannot be 



(OUT OF MEMORY 
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The 256 byte procedure/ buffer has been tilled and there 
is no more room lor procedure ilcl'i nil inns. There is room 
for appro*. 25 definitions in one program, though this 
amount is rarely deeded. You could also have loo 
many nested FOR. ..NEXT or GOSUB... RETURN 
s. Try using POP to escape from subroutines. 



'SYNTAX ERROR 

The Busibasic interpreter cannot understand your Basic 
program line, and the error cannot be included in the 
other categories. Check the spelling of the command, 
that parameters are in range, lh.it commas are in the right 
places and that you ha\ 
parameters. 



LHint of 



Busibasic expected a certair 
provided. Maybe you put a 



UNDEF. PROCEDURE 



You have called a procedure by a name which cannot be 
found in a .DEFPROC command. Check the spelling 01 
both procedure names. 



?WINDOW ERROR 

You have made soi 
command. Their nu 



MEANING 

SYSTEM FAILURE-RELOAD 

BUSIBASIC 

NO WINDOW EXISTS 

WINDOW ALREADY EXISTS 

BAD X 

BAD Y 

BAD WIDTH 

BAD HEIGHT 

BAD X + HEIGHT 

BAD Y + HEIGHT 

BAD WINDOW NUMBER 

NO MEMORY AVAILABLE 



'TOO MANY DIMENSIONS 

The SORT command can only deal with arrays of c 



ariable type which was not 
tring in place of a number 
occur if the variable type 
not the same as in the 




DEMO PROGRAM 

The Busibasic demo program is loaded from Busibasic 
by typing D LOAD "BUS I DEMO". It is an attempt to 
demnnslrate how a file handline desktop emu , mruerir 
could be created. It is not an elegant piece of 
programming, but it works and it shows ofi the system 
and it's commands. It could be improved further by the 
utilisation of windows, icons and properly structured 

When writing this I noticed something odd. I have set the 
pointers inr strings ,ind tiasic storage at T.J-Si and 55-56 
to SBFFF, just below Busibasic. This is to ensure that it 
does not get corrupted. But during development, f 
noticed thai the Basil' J system kept reselling the string 
pointer to SAGOO. This is in spile of the fact that the 
tiighe-t legal address in 55 and 36 was still SBFFF! This 
results in the frequent corruption of the Busihasic 
operating system by variables. Is this a bug in the ROMs 
or my programming Either way, you will have to be 
very careful about variables; save your program 
regularly. 

When the desktop is up and running you have a joystick 
or cursor-keys controlled pointer. The bar at the bottom 
is disk status. The baron the right is the amount of space 
on the i urreni disk. The bigger the bar, the more space 
available. The bar along the top gives free memory and 
tile three pull down menus. The centre window is where 
all dialog takes place. Click on any of these 

anents and they will react. Below is a 

ption of the n 



DISK: Normal disk commands. Type the required |6 
' "' in cancel or confirm when prompted. 



it the bottom of the window to see more 
. DIR should only be used when a new 
been inserted. LIST will display the 



les to load that pai 
newhenafilenam 
is presumed to be 



4(. 



ON THE DISK 



t the directory into alphabetic.il order. DUMP v 
nl the directory to a device 4 printer. When used w 
t„ this is a very powerful asset. Use DIR to return 
■ normal format directory. 




CLOSING POINTS 

It is difficult to summarise the working ot ,1 
language wilhin (he constraints of a magazim 
hound to he something that I have torgullcTi i< 
My advice: experiment. 

The demo program pro\ idc/cl should point the 



TheremavVJ 



i.tnd. 



.i piouiu 



(■ pro.nr.i 



nini! <, 



lagazin 



\m ij;rai 

prograi 



e Ed 



usibasit to make my 
isier - I hope thai you find the same 
tor may even consider publishing 
ith Busibasic. Why not try your luck 
masterpiece - it may earn you some 



BUSIBASIC COMMAND SUMMARY 



$ hex number 
% binarynumber 



.DEFPROC procname (oplio 
.ENDPROC 



.PROC procname (optional parameters) 

ARROW speed,colour 

BAR screen location, colour, height 

BEEP 



BOX x1,x2,y1,y1,top line.bottom 
line, colour, reverse flag 
CLINE screen line 
CLS 

■ COLOUR cursor,background,screen 
DAPPEND "filename" 
DIR 

DLIST "filename" 
DLOAD "filename" 
DOKE location^ 6-bit value 
DOS 

DOS "disk command" 
DOS$ 

DSAVE "filename" 
DUMP 
FAST 
SLOW 

FKEY"fl ,f3,f5,f7,f2,f4,f6,f8" 
ICON icon number,flag 
INSTRING target string,,search string, result 
|OY 
KEY WAIT 
LOCATE x,y 
LOWER 

MENU return variable%,choice array(0),zone 

OLD 

POINTER 

POP 

POSICON icon number,x,y 
PTRICON icon number.design block 
QUIT 

REVERSE screen location, number of characters 
SETICON 

icon number,type,colour,Xexp,Yexp,priority, 

col1,col2 

SLEEP time 

SLOW 

SORT array name 

TYPE"filename,filetype" 

UPPER 

VARPTR variable,return variable 
WCLR 

WDELETE window number 
WDISPLAY window number,x,y,flag 
WLOAD "filename",8 
WSAVE "filename",8 

WSTORE window number,x,y,width,height 



ON THE DISK 



BASIC SLIDER 



Another routine for producing pleasing text, by DAVID READ 



s at my compute* one night, experimenting with (from the program CHARS. MO a 



string anil lilt.' commands lh.il deal with ther 
quite by accident, I discovered a small rouiine lhat 
improve (he presentation of a program with a 
number of text screens. 



HOW IT WORKS 

s by tal 



effects that can be made. You then have the option of 
loading the Basic Slider routine, restarting the 
demonstration In have another look at Ihe eipLirijIion-.. 
or resetting the computer. 

MERGING IT IN 



tie character from the 
i printing them on the 
l"HI5 would print S, IS, 
" the line sliding 




You can put the rouiine into your own program by 
loading the SLIDER.SUB program from the disk and 
building your program around it, or using a MERGE 
command from a version of (.■■lended basic, or you can 
use this method, which is slightly more complicated. 



s 51 and 52. You ihen set the start of 
;o these values, and you can now load 
ice it has loaded, POKE 43,1 and POKE 
Tidn.il program back. 



1A=A+1:IF A=1 THEN LOAD "CHAKS.MC",8,1 

2 IF A=2 THEN POKE 53272,24 

To switch off the characters, type POKE 53272,21 



The routine, filed on the disk as SLIDER.SUB, when 
given a line of text 40 characters long in AS. will slidr il 

which would in j ke the si rim more interesting to look 

commands part of your profiram: 



Basic Slider is 

smoothly, and v. 
as well, but it 

up with a better 



BASIC SLIDER 

inly a simple way of 



de ihe text much more 
ild allow i olours and sound to be used 
lis is beyond me tat the moment}, 
machine code programmer will come 



30 .... rest of program .... 

The routine supports user-del inud characters, and will 
not interrupt the variables in ,i program, as long as AS 
is not used. You can also put a delay between each 






letter, by adding iht- eilliiv, nig line to Ihe routine: 


[jiijfjj 






10007 FOR <variable>=0 to <delay>:Nc.XT <variable> 






DEMONSTRATION 






Also on the disk is a demonstration program called 
Basic 5lider, which shows how the rouiine works with 







ADVENTURING 




Character An 



JASON FINCH 



RESPONSES 



When (he program has sussed o 
talk Ic 1 



embark on how 



1 1 v U*' 1 'he Ihtnp, up and rc 

COMMUNICATIONS 



Here of course we are not thinking of setting up our a\ 
telephone network or anything throughoul the adventu 
we are la Iking ahoul Ihe pl.ncr ( ornmunicating on a or 
to-one basis with ihe olher characters. You must also tx 
in mind how the computer will tell the player wr 
actions the other character is performing, if any, and al 
what is happening elsewhere in the adventure if it is 
importance. 



TALK TO THE ANIMALS 



The most obvious way in an adventure that Ihe player 
lalks to the animals anrl other characters is by way of the 
SAY and ASK commands. These usually take the form 
SAY HELLO TO THE ELF. However, you may want to 
make your adventure so that quote marks are required 
around the speech. This is probably best because it 
clearly defines what the player wishes to say. And how 
are you going to make your adventure cope with inputs 
that are ''around Ihe wrong way" such as 5 AY TO THE 
ELF HELLO. Quote marks make il easier lo instantlv pick 
out Ihe tew: SAY TO GANDALF "PICK UP THE AXE", I 
won't go to deeply into the way that your program Will 
analyse that particular command ■ that will be talked 
about next month. Suffice it to say thai ihe program will 
take Ihe wordfs! immediately lolhiwing 'TO' lo be ihe 
character and the wordtsl in the quotes lo be what you 



mple, 



that. Y 



clear distinction between SAY and ASK if 
include Ihe ASK option. You should ensure lha 
"HELLO" TO THE ELF creates a suitable resr. 
whereas something like ASK THE ELF "HELLO" si 
obviously strange. You usually ASK a question. 



lake a 



is you 



say, Ihe 



decide whal a suitable reply foi that character would be. 
This is a simple form of Al (Artificial Intelligence to n 
people). You must choose how complex you wanl 

have no character 1 ; Ihen all well and good, you d' 
need lo worry about communicating, but ihe m 
characters you have, and Ihe more you wanl the playei 
lo rely on speaking to others (which shouldn't be 
much!) ihen Ihe more Complicated your speech ana 
routine will become. If il isn't all lhat important Ihen 
can have a sel of lived responses to certain statement 
questions. Otherwise you can have Ihe routine "think" 
i mi: vvh.il si if; > A iiue-slicc :■■ i ■ l ■ 1 1 1 ■: : .icswetvi'I .':rlil then put 
together a reply. For instance, Ihe former may result in 
the computer displaving "The little man says 'no'" if you 
say to him PUT THE CUP ON THE TABLE, whereas Ihe 
more advanced reply routine may say "The lillle man 
says he wants lo hold the cup". This response would be 
changed if you said PUT THE SWORD ON THE TABLE 
or sornelhing. I hope thai will give you some food for 
Ihought on the c omple\ily of vour routines anil whether 
you actually need a super-advanc ed system. 



WHAT'S HAPPENING? 



The last word for now on communications is lelling ihe 
player whal olher characters are aclually doing. Most of 
this will he (iisi Listed in Ihe programming aspects ser t ic in 
next lime, but for now jusl give a bit of thought lo Ihe 
pciMiii.ilitie- thai ynor r h.iraclers, if any!, will have. In 
The Hohbil there was one character thai constantly 
talked to himself. Fine, so you display messages like " I he 
elf lalks quietly lo himself". Bui movemenl is harder to 
do. The ideas are simple enough. "The guard leaves the 
room". But how will it be possible lo lell whether he can, 
and how will Ihe computer know where lu- -JioulH the" 
be placed! All will be revealed next month!! 

With a bil of luck this won'l have extended too far onto a 
second side, il al all. So without further aria, I shall SAY 
"CHEERIO FOR NOW" TO THE READERS! See you all 



ISKUSER 



0908569819 




CLASSIFIED COUPON 

ALL CLASSIFIED ADVERTISEMENTS MUST BE PRE-PAID 
THERE ARE NO REIMBURSEMENTS FOR CANCELLATIONS. 
CDU CLASSIFIED DEPARTMENT, ALPHAVITE 
PUBLICATIONS, 

?0 POTTERS LANE, KILN FARM, MILTON KEVNES, MK11 3HF. 



ONLY POOLS AND HORSES 

Every program written by a mathematician who has spent many 
years in the betting industry. Programs that utilise the triad and 
trusted methods ot the professional, not pie in the sky theories 
that fail to pass the test of time. 

FOOTBALL BOXFORM Wrrtfar, by a former pools eicperl for 
LrtHiiwrjoos. The program has forecast over 50% more draws than 
wouid be expected by chance. 

Hemes, Aways and draws shown In order of merit and true odds given 
for every matoh. Merit tables show at a glance the teams currently In 



POOLS PLANNER by the same author. Full details given of 3 
easily entered block perms ranging from 9 to 73960 lines an 
from 12 to 56 selections. All are accepted by the pools firm! 

and are checked in seconds By your computer. 
RACING B 



order of merit for each race. Designed for flexibility allowing u 
amend the program if they vriBh. Price still includes the highly 
acclaimed HANDI CAP WINNER - more than 1000 winners every year 
over 251* of them at 07t or better. Order two or more and receive FR6I 
a program 1o work out Smost any bet, So goad its used by bookies. 



KSI 



WORTHING 


REPAIRS 


COMPUTERS 




Tel: 0903 210861 




7 WARWICK ST 




WORTHING 




WEST SUSSEX 


HOME WORKERS WANTED 


Stockists of a large 
range ol 8 Bit and 
16 Bit 
Software and 


I Mailing Envelopes ) 
£3. per Hour. 


STAMPED 5.A.E. TO 


Peripherals, 


MATKIZA 

27 WOODSIDE PLACE 
GLASGO G37QL. 




SILICA SYSTEMS OFFERS YOU 


IDHDDN EHDP ; ^l2*»« 

lONDDH StW:' ^ ' S.ivi-Ja,-, Stani SmMindon. iffll Ha" T.I 171 KI rJH 
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| PLEASE SEND CITIZEN PRINTER INFORMATION | 
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